NOS/VE Cycle 7 Helpful Hints 



CYCLE 7 HELPFUL HINTS 



09/14/82 



This paper describes helpful hints on hoa to use Cycle 7 of ' 

M03/VE* It is intended to supplement* rattier than to replace.* J 
the standard NOS/VE documentation. If you have any questions or 
suggestions* please see Tom He Gee or Bonnie Swierzbin* Appendix 
D lists background documents and hon to obtain thaw, 

To obtain additional copies of this document while running on 
SN101 at Arden Hills* please type? 

SES* INT1.LISTHINT5 C=<nurafeer of copies> 

To obtain a copy with revision bars against the Helpful Hints 
of the previous build* one can type: 

SES* INT1.LISTHINTS RfcVB C = <nu*?ber of cocies> 

The C parameter is optional and defaults to one* 
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1.0 MAJOR CHARACTERISTICS OF THIS BUILD 
1 * !lAiQ&.£aARAi:iE&ISIiaS-QE-IUIS-fiiULD 



o Cycle 6 and subsequent cycles of NOS/VE are built to run with 
a NOS 6.1 base system and the DSD displays and commands have 
changed considerably from the NOS 5*3 base system used with 
Cycle 5. This hints document has been updated to reflect 
these changes where they affect NOS/VE* for instance* using 
the command NVEnnnn to bring up NOS/VE instead of cp.NVEnnnn* 
For more information on the NOS commands see SJ Swierzbin's 
memo of July 23 titled »M0S 6.1 Notes 1 * the NOS reference 
manuals listed in Apoendix A* or the NOS R6 Software Release 
Bulletin. 

o To access NOS/VE interactively* the user must login to the 
application named VEIAF. For example: *DAH»DAHX* VE IAF The 

previous application name was TAF. 

o With Cycle 7* the operator of the NOS/VE dual state system can 
simulate terminal breaks. She/he may issue at any time a 
♦BREAK at the K display for the NVE job. This will start the 
terminal break.? which vtorks just like the interactive break. 
The broken command may be continued by issuing the 
resuffle.contnd (rase) or may be terminated by issuing the 
terminate_command (terc). If the coumand get.fi le is broken 
into* the command hi I I be terminated by the Remote Host. 
After the DS proc has been executed* a terminal break at the 
command level will cause the SCL task to terminate* The job 
monitor task will restart the SCL task after a brief delay (up 
to 20 seconds ) • 

o Miscellaneous SCL Changes: 

A R IMG parameter has been added to the TASK/ TASK END 
command. This parameter may be used to switch to a new ring 
of execution within the user's validated minimun_r ing and 
nom ina l_r i ng. 

A SRXNG function has been added* It has no arguments and 
returns the current ring of execution. 

Commands from user jobs are no longer written to the system 
log by default. This function is controlled by the new 
operator commands ACTIVATE_SYST£M_10GGING and 
DEACTIVATE_SYST£M_LOGGING. 
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1.0 f*!AJOR CHARACTERISTICS OF THIS BUILD 



The abbreviation for the SKIP_TAPE command H&s 
corrected to SKIT from SKIPT. 



een 



A new internal interface., CLP$VALIDATE_NAM€ has been 

added* This is an INLINE procedure that should be used 

instead of the high overhead CLPSCOHVERT.STRING.TO.NAHE . CSee 
common 'deck CLXVN for interface details.) 

DISPLAY_FILE leaves the source file with an attribute of 
RT*U. This can be corrected by setting the RT attribute back 
to the correct value after the DISPLAY value: SETFA file RT*V 



COPY.FILE wilt not copy at ECI if it had baer\ specified on the 
COPF command. The foil owing sequence will accomplish copying 
at EOI: 

SETFA dest.fi le 0P=SE0I 
COPF source.fi Je dest.fi le 
SETFA destf i le 0P=$8QI 



o The permanent file system has been modified to make files * 

invisible when all cycles have been purged even if on» or pore J 

of those cycles are still attached. This results in J 

references to the file emitting an unknown file message as * 

expected* rather than ^n unknown cycle message containing an \ 

inyalid cycle number. It also prevents display catalog * 

commands from showing the file as having zero cycles. \ 

o The administer utility has been updated to correspond to Rev. * 
9 of the HOS/VE Command- Interface ERS. Old command bt\6 I 
parameter names are no longer supported. 1 

o The TAFNVE operator command CTAF control point) is no longer S 
required or available. The capabilities that were provided by 
it have been packaged within the NV£ subsystem control point. 
The impact of this change is as follows: 

- The K display is assigned to the saie control point 
during both deadstart. and normal system operation. 

Output from the system core debugger will no longer 
appear at the NVE control point K-display. All system 
core debugger communication is via the HOD terminal. 



- The K.*BYEVE 



command is no longer available 



- The GFFSW»jsn»6« command before doing a STOPjjsn. is J 
not required to bring NVE down. J 
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1*0 MAJOR CHARACTERISTICS OF THIS 8UILD 

- All capabilities are available via the NVExxxx* 

command* The HVE subsystem may be placed at any controi 
point (like NAM Is )• 

o Cycle 5 (actually Cycle 4) of NOS/VE no longer supports the 
"old** command names for system commands* Both "old** and "new" 
names have been supported since Build Q, See DAP APH4776 for 
details* As part of this change the abbreviations for the 
CQPY.FILE and PRINT.FILE commands have been corrected to CQPF 
and PRIF (from COPYF and PRINTFK 

o The EXPLAIN command his implemented in Cycle 4 of MOS/VE* 
Don't get too excited about this.* however* because as yet 
there are no "explain level** message templates for any of the 
system conditions* EXPLAIN Mill simply regurgitate the 
regular mess age* 

While implementing the EXPLAIN command it was discovered that 
the specification of the command (i.e. that It have an 
optional "condition** parameter) was not nearly as useful as 
having the first parameter be a "status" value* So the 
Imp tenenta t ion deviates from the EPS in that the first 
parameter to EXPLAIN is HESSAGE.STATUS or HS and is of Kind 
STATUS* The SSTATUS function can be used to transform a 
"condition" into a "status**. A DAP is being written to make 
this' change official. 

o NOS/VE multiple mass storage volumes have been implemented in 
Cycle 5* For more information see the section *Conf i gurat i on 
Management* • 

o The implicit attach process has been modified to choose share 
mode to be the following function of access mode* If access 
mode includes shorten* append or modify then share mode is 
none* otherwise share mode is read and execute. This results 
In allowing sharing of implicitly attached files that are not 
being written but inhibiting sharing of implicitly attached 
files that are being written. 

The implicit attach process formerly chose share mode to be 
the share requirements established by the permit mechanism. 
The owner of files typically has no share requirements and 
hence would implicitly attach the files for exclusive access. 
This created a severe usability problem for code or command 
files that were to be executed by multiple jobs. 

o An EOI problem exists with respect to a file shared between 
jobs. An existing file is opened with an access mode of 
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1*0 MAJOR CHARACTERISTICS OF THIS BUILD 
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append by job A* The same file is opened with an access mode 



of read by jots S. 
explicitly closes the 
cl oses the file or 

access i ng the file in 

extended the f i I e* 



Job A extends the file and either 
file or terminates. Job 8 explicitly 
terminates* In this case* since the job 

read mode terminated after the job which 
EQI on the file will be reset to the 



original position %n& the result of the extend will be lost* 

The Interstate Communication Facility* which is described in 
Section 9 of the NOS/VE ERS - Program Interface IRev. 8)* has 
been Implemented* The callable subroutines described in 
section 9.3 reside in User Library LINKLIB in the Integration 
catalogs INT1* DEVI* R£L1* etc. NOS libraries SYSLI8 and 
SRVLIB are also required to complete the loading process* 
L9SET loader commands must be used to select these libraries* 

Interactive Usage Restrictions: 



When logging in to NHS/VE (i.e. HELLtbVEIAF etc*) do not 
enter a terminate break (CTRL t) or a pause break (CTRL p) 

before the 'welcome message' appears at the terminal* A 
pause or terminate break entered before the interactive 
NOS/VE job has completed it's initialization may crash the 

system* 



A REQU£$T_TERHXNAL command in a batch job will crash the 
system* This can happen accidently through a 
REQUEST.TERfllNAL command in a user prolog when the user 
runs a batch job since the prolog is executed for both 
interactive and batch jobs* The problem can be avoided by 
making the REQUEST. TERMINAL command in the prolog 
cond i t I onal on the job type as follows* 



IF SJ08<HQ0E) <> 'BATCH* 

REQUEST. TERMINAL 
IFEND 



THEN 



o Any product or utility that is placed in the SSYSTEM catalog 
(or any frequently loaded program) should be bound using the 
CREATE.MODUIE subcommand of the CREATE J3BJECT.LIBRARY 
utility* This will minimize overhead associated with loading 
the product or utility* 

o Debug responds to terminal breaks when a program is being 
debugged* However* entering a pause or terminate break when 
debug is active (i*e* the 08/ prompt has appeared and the 
user has not issued the RUM command) will cause the task to 
termi nate • 



Cycle 7* July-August 1982 



1-5 

NOS/VE Cycle 7 Helpful Hints 

09/14/82 

1.0 MAJOR CHARACTERISTICS OF THIS 8UIL0 

o When sharing executable files via permanent files (i.e. 
compi I ersf libraries* etc.) you should make the file an 
object library via the CREATE. OBJECT.LIBRAPY utility. By 
sharing object libraries instead of object files* the code is 
actually shared among all tasks using the library? the library 
Is not copied to another segment but is executed directly. 

1.1 aasm.!ISA££_E*AaEL£S 



1.1.1 EXECUTING PROGRAMS 



PROCESS 

Create an object text fife by compiling a program on NOS. 
Then perform the following steps on NOS/VE: 

Acquire any necessary libraries (which are a&£ quoted in text 
embedded directives) by either: 

o Attaching them from the system catalog* either explicitly 
or via prolog 

or 
o Creating the library file via the object library generator 

or 
o Staging the library file from NOS to NOS/VE using the 
GET.OBJECT.LIRRARY command. 

Get the file from NOS and convert the object text file from 
the CI data mapping to II data mapping by executing the 
C0NVERT.a8JECT.FILE command. 

Load and execute the program via the EXECUTE. TASK command* 
specifying the necessary libraries with the LIBRARY parameter; 
alternatively SET.PROGR AH. ATTRIBUTES may be used to include 
the libraries in all subsequent EXECUTE.TASK commands. 

- Stage the Joadmap from NOS/VE to NOS for printing by using 
ei ther J 

o The REPLACE. FILE command with A6 conversion mode specified 
if running on the simulator. 

or 
o The PRINT. FILE command if running on the hardware. 

EXAMPLES 
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1,0 MAJOR CHARACTERISTICS OF THIS BUILD 
1.1.1 EXECUTING PROGRAMS 

The following Is an example command sequence for executing a 

program not requiring any libraries for loading: 

Assump t i onsJ all modules to be loaded are contained on the NOS 
permanent file * citxtrs 1 . 

CGNVERT.OBJECT.FILE CITXTRS 

EXECUTE_TA$K CITXTRS PARAMETER* • program parameters' 
PRXNTFILE LOADNAP 



The following is an example command sequence for executing a 
pro gran requiring libraries for loading! 

Assumptions: the NOS permanent file 'citxtrs 1 contains object 

text generated by the CYSIL CI compiler* The compiler modules 
reference procedures contained on the library 'mylib 1 and the 
CYSIL run-time library. These libraries have been generated on 
NOS/VE and saved on NOS. 

GETJ38JECT.LIBRARY MYLIB 

SET.PROGRAM.ATTRIBUTES L0AD_MAP_0PTI0N$= ( BLOCK* ENTRY_P0I NT* SEGMENT 

C0NVERT_OBJ£CT_FILE CITXTRS 

EXECUTE.TASK CITXTRS 'program parameters 1 LIBRARY«MYLI3 

PRINT.FILE LOAOMAP 



1.1.2 CREATE OBJECT LIBRARY QN NOS/VE AND SAVE IT ON NOS 



o CLG0170 is NOS permanent file name for file containing CI 
object text for modules to be included in the library. 

o IITEXT180 is NOS/VE local file name for file containing II 
object text for modules to be included in the library. 

o LIBRARY180 is NOS/VE local file name for the library being 
created. 

o ILIB170 is NOS permanent file name for file containing the 
library. 

NOS/VE Job Commands 



CONVERT_OBJ£CT_FILE IITEXT180 CLG0170 

CREATE_GBJECT_LIBRARY 

ADD.MODULE LIBRARY=IITEXT180 



Cycle If July-August 1982 



1-7 
NOS/VE Cycle 7 Helpful Hints 

09/14/82 

1,0 MAJOR CHARACTERISTICS OF THIS BUILD 

1.1.2 CREATE OBJECT LIBRARY ON NOS/VE AND SAVE IT ON HOS 

GENERATED 1 8RARY LI8RARY*LI 8RARYI8C1 

QUIT 

REPLACE. FILE UBRARY180 ILI8170 DOB56 

1.1.3 HODIFY A PREVIOUSLY SAVED OBJECT LIBRARY 



o ILIB170 is HOS permanent fiJe name for file containing the old 
I i brar y 

o LI8RARY180 is MOS/VE local fife name for file containing the 
old library 

o CHQD170 is NOS permanent file name for file containing CI 
object text for the nen module 

o NEWIINODULE is MOS/VE local file name for file containing II 
object text for the new module 

o NEWLIBRARY is NOS/VE local file name for the library being 

created 

o NLIB170 is NOS local file name for new library 

HQS/VE Job Commands 

GET_QBJECT_LIBRARY LIBRARY180 ILIB170 

CDNV6RT_0BJECT_FILE NEWIINGDULE CM00170 

CREAT£_OBJECT_LIBRARY 

ADDJ10DULE LIBRARY*! I3R ARY180 

REPLACE.MODULE LI8RARY*NEWI IMQDULE 

GENERATE. LIBRARY LIBRARY«NEWLIBR ARY 

QUIT 

REPLACE.FILE NEWLIBRARY NLI8170 DC*B56 

1.1.4 ROUTE AN INPUT FILE FROM NOS TO NOS/VE 



Running from an interactive terminal* enter: 

GET* f i lenama* 

R0UTE*fi lename*DC«LP,FC»RH. 

The input file which is sent to NOS/VE must be in 6/12 ASCII 
{or display code subset). The job file must be a single 
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partition NOS record containing NOS/VE commands. The first 
statement must be a valid LOGIN command with user* password and 
family name specified. flu It i partition input files are not 
supported by NOS/VE so NOS data files used by the program roust foe 
obtained through the G£T_FIL£ co»»and» 



1.1.5 PRINT A NOS/VE FILE 



At NOS/VE job termination the job 
returned to NOS. The job log will be 
output file OUTPUT. NOS/VE print files 



log Mill be automatically 

appended to the NOS/VE 
aiust be written by 8AM as 



8/8 ASCII RT*V. Print files will be 
RT»V to NOS 8/12 ASCII when they 
printed in upper/loner case. 



converted from 
are sent to NOS 



8/8 ASCII 
and will be 



All NOS/VE output files will appear in the NOS output queue 
{NOS H/Q display) with the name IRHFxxx as a banner. In order to 
print a NOS/VE file? the following command must be issued within 
your job or be entered from the system console via the operator 
f ac i I i tyi 

PRINT. FILE f i lename 
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2*0 CfliJaAMfi-IJai£££AC£-SIAXUS 



2 . 1 A£££SS-Ifl-fclOSZy E-Ili-ayAL-SIAI£ 



2.1.1 LOGIN TO NOS/VE 



To initially login to NOS/VE via VEIAF* you must cause the 

first login attempt to fail. This can be done by responding to 
the "FAMILY:" login prompt with something likes *******. This must 

be done because the system will try to connect the terminal to 

IAF on the first login attempt no matter what is typed. To 
access VEIAF do the following on the second "FAMILYs" prompts 

*user>password*V£IAF 

You can access VEIAF from IAF by doing M H£LLO*VEIAF M or by 
answering VEIAF to the system prompt "APPLICATIONS". 



2.1.2 TERMINAL USAGE 



1) The slant (/) is the prompt to enter a NOS/VE command. Any 
normal NOS/VE command can now be entered (continuation 
lines are prompted with ../). The full ASCII character 
set* lower or upper case and all special characters* can be 
used. 

2) A LOGOUT command will cause the NOS/VE Interactive Job to 
terminate. A new NOS/VE Interactive Job can then be 
started by responding to the •APPLICATIONS* prompt with 
VEIAF. 

3) Terminal breaks (controt-t and control-p) can be used to 
terminate a task or command and suspend a task and enter a 
new task to process SCL commands. Control -t causes a 
terminate break and control-p causes a pause break. 
Terminate break will terminate a command or the most 
recently executed task. A pause break will suspend 
execution and allow commands to be entered. When a 
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2.0 COMMAND INTERFACE STATUS 
2.1.2 TERMINAL USAGE 

terminal Is in pause break state* two additional commands 
are available: 

RESUME_COMMAND - resume execution at the point of 

Interrupt ion. 

TERMINAT£_COMMANP - cause a terminate break condition as 

a terminate break had been entered. 

Both terminate break and pause break are available to programs 
as conditions via the program management condition mechanism* 

2.1.3 NOS/VE PROGRAM ACCESS TO THE TERMINAL 

1) Interactive NOS/VE jobs are able to obtain terminal input 
through the AMP$GET_NEXT or AMPSGET.PARTIAL program 
interface which can be used by both task services and user 
ring programs* Interactive programs which use this 
Interface should be able to handle both upper and lower 
case input in order to make them more convenient to use in 
both 64 and 96 character set modes. 

2.2 £Q!»JAiia-Atm_EA£A&£I£E_tiAtlES 

During the next few months a command supported by the system 
may not be in sync with your command interface document* The 
parameter descriptor table gives an accurate* concise description 
of the command interface as currently supported. 

The definition of a command's parameter list is enclosed in 
parenthesis with a parameter description per line. Each 
description has the general form: 

PARAMETER NAME: ALLOWED PARAMETER VALUES » PARAMETER DEFAULT 
VALUE 

Parameter Names - describes the parameter name and any 
abbreviations. 

ALLOWED PARAMETER VALUES - describes the kind of value allowed 
and whether a list of values is possible. The value kind can be 
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2*0 COMMAND INTERFACE STATUS 
2.2 COMMAND AND PARAMETER NAMES 

further qualified. In some cases* the actual values allowed are 

described using the KEY notation. The value kinds include 
INTEGER. STRING, NAME* FILE* STATUS. 

PARAMETER DEFAULT VALUES - describes the defaulting rules 
and/or values for the parameter. SREOUIREO and SOPTIQNAL are 
obvious. Other values in this position will be treated as if 
they were entered by the user on command invocation. 

See the PROC command in the Command Interface EPS for more 
detai I s. 

The PDTs for the commands currently in the system can be 
displayed using the 0ISPLAY.COMMAN0. INFORMATION command. This is 
documented in the nonstandard command section of this document* 



2.3 £QiiaiLiia_EiJsciiQss 



EuB&tiao 



i£a±u& 



$M0D 

$CHAR 

SCLOCK 

$DATE 

$FILE 

SFNAME 

SINTEGER 

$NAME 

SORO 

SREAL 

SSTRING 

SSTRLEN 

SSTRREP 

SSU8STR 

SUNIQUE 

$TIME 

$VAR 

SSPECIFIED 

$SET_C0UNT 

$VALUE_COUNT 

$RANGE 

SPARAMETER.LIST 

SPARAMETER 

SSTATUS 

SC0N0ITX0M 

SSEVERITY 

SPROCESSOR 



unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
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2.0 COMMAND INTERFACE STATUS 
2.3 COMMAND FUNCTIONS 



MmM&*MmtMM»0MmMM&MMmM*i**r4*&*tM&MtmWtMWMMMMmim4*&MimMM'M**&m***t1lt**.**M**4**l****M»l»***mi**ai*l*» 



:J0B 

.PROGRAM 



unchanged 
unchanged 



2.4 SISI£a.A£££SS-£QHflAtifiS 



SET.LINK. ATTRIBUTES 

LOGIN 

LOGOUT 

SET.PASSWORD 



unchanged 
unchanged 
unchanged 
unchanged 



- *1 



*1 The family name of the job doing the submit will be used as 
the default family name on batch jobs. The default for jobs 
submitted from NGS will be family SSYSTEH. This effectively 
means that whenever NOS/VE jobs are submitted from NOS the 
family parameter is required. 



2.5 £££ail£££-iSM£££!i£!SI 



QanaasI 

REQUEST. TERMINAL 



unchanged 



2.6 EIL£_aAtiA££tt£fciI 



daj&aaiid 

SET. FILE. ATTRIBUTES 
COPY. FILE 
DISPLAY. FILE 
COMPARE. FILE 
OISRLAY.FILE. ATTRIBUTES 
SKIP. TAPE 



unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 



2.7 ££&liAM£ai_EIL£. 

Caimanji 

GET.FILE 
REPLACE. FILE 
CREATE. FILE 



.SMA££M£MI 



unchanged 
unchanged 

unchanged 
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2.0 COMMANO INTERFACE STATUS 
2.7 PERMANENT FILE MANAGEMENT 
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ATTACH.FILE 

DELETE.FILE 

CHANG E_CATALOG_ENTRY 

CREATE. FILE.PERHIT 

D£LETE_FIlE_PERliIT 

CREATE.CATALOG 

OELETE.CATAtOG 

OELETE.CATALOG.PERHIT 

CREATE.PERHITJTATALQG 

QISPLAY.CATALQG 

OISPLAY.CATALOG.ENTRY 

SET.WORKING.CATALOG 



unchanged 
unchanged 

unchanged 
unchanged 

unchanged 
unchanged 
unchanged 

unchanged 
unchanged 
unchanged 
unchanged 

unchanged 



.8 SCL-SIAI£M£t4lS.AWQ-£BaaEQUa£S 

PROC/PROCEND 

SET.COHFiAHO.LIST 

DISPLAY_C0f1MAND_lIST 

REPEAT/UNTIL 

WHILE/WHILEND 

CREATE.VARIABLE 

DELETE.VARIA8LE 

BtOCK/BLOCKENO 

LOQP/LOOPEND 

FOR/FOREND 

IF/EISEIF/ELSE/IFEND 

CYCLE 

EXIT 

WHEN/WHENEND 

CONTINUE 

CANCEL. 

INCLUDE.FILE 

COLLECT. TEXT 

DISPLAY_VALUE 

EXIT.PRQC 

ACCEPT_LINE 

INCLUDE.LINE 

CREATE.f ILE.CONNECTION 

OELETE.FILE.COHHECTION 

OI$PLAY_FXLE_CONNECTION 

change HCS variable 

d i spI ay HCS var i ah I e 



Status 

unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
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2,0 COMMAND INTERFACE STATUS 
2,9 INTERACTIVE COMMANDS 



2,9 IttI££AaiIM£_£fl!!MMO£ 



Canae^ 



iialys 



RfcSUME.COMMAND 


unchanged 


TERMINATE_CQMMANO 


unchanged 


SET.TERMINAL. ATTRIBUTES 


unchanged 


DISPLAY.TERMINAL.ATTRISUTES 


unchanged 


esc-e 


new - 1* 


e s c- 1 


new - 1* 


ese-j 


new - 1* 


esc-t 


new - 1* 


e s c- x 


new - 1* 



*1 These commands are entered with 
escape. key* character* car r J age. return* 
the following meanings: 



the 3-key sequence! 
The characters have 



e perform **di so I ay.joh.status w command 

I perform **disp I ay. log 10 w command 

j perform M di so I ay. job. status all** command 

t discard all unprocessed* typed-ahead input 

x terminate job* but do not disconnect 



2.10 Qfi,LE£I_£flDE_aAiaiEMAB£E 



Caaaiaad 



Status 



C R EAT E.OB J EC T. LIBRARY 

DISPLAY. HEW. LIBRARY 

SELECTED ISPL A Y.OPTI ON 

ADD.MODULE 

REPLACE. MODULE 

COMBINE. MODULE 

CREATE. MODULE 

SIND. MODULE 

CREATE. PROGRAM. DESCRIPTION 

DELETE. MODULE 

CHANGE. MODULE. ATTRIBUTE 

SATIS FY. EXTERNAL. REFERENCE 

REORDER. MODULE 

GENERATE. LIBRARY 

DISPLAY. OBJECT. LIBRARY 

COMPARE. OBJECT. LIBRARY 

QUIT 

CI to II Conversion 



unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
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2*0 COMMAND INTERFACE STATUS 
2.11 USER SERVICES 



2. IX US£a.S£RMIC£S 

0ISPLAY.LOG 
DISPLAY. MESSAGE 



unchanged 

unchanged 



2.12 EiL£.aauiiiifi 

HCS JMROUTE 



r emoved 



2.i3 ££asRAa-£*££uiiaa 

SET.PRQGR AM. ATTRIBUTES 

DISPLAY PROGRAM 

EXECUTE 

"name call" 

TASK/TASKEND 

TERMINATE. TASK 

HAIT 

SET.DEBUG.RING 

DISPLAY.ACTIVE.TASKS 



unchanged 

unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 



- *l 



*1 Warning - "name call" works only for SCL procedures unless a 
SETFA command has been issued to specify that the 
FILE. CONTENTS are OBJECT and the F ILE. ORGANIZATION is DATA or 
LIBRARY* The SETFA command must be reissued every time the 
file is brought over from NOS. The CONVERT. OBJECT. FILE* 
GET.OBJECT.FILE, and GET.QBJ ECT.LI8R ARY nonstandard commands 
issue the appropriate SET. FILE. ATTRIBUTES command and are 
therefore recommended* 



2.14 iflft_aAaA££a£HI 
Caauaaad 

SUBMIT.JD8 
DISPLAY.J08. STATUS 
TERMINATE. JOB 
PRINT. FILE 
TERMINATE. PRINT 
DISPLAY. PRINT. STATUS 



unchanged 
unchanged 
unchanged 
unchanged 

unchanged 
unchanged 
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2.0 COMMAND INTERFACE STATUS 
2.15 HON STANDARD COMMANDS 



2.15 afla-sutfQA&Q-aaaaAiias 



The following commands provide a nonstandard means of 

performing various frequently performed functions. They may foe * 

superceded In subsequent builds by standard commands and * 
capabi 1 1 1 i es. 



2.15.1 OELETE^CATAtQG.CQNTENTS I DELCC 



The purpose of this command Is to delete all entries from the 
specified catalog. This includes subcatalogs and the files they 
eon tai n. 

del ete_cata-log_ contents Ccatalog-<eata!og>] 

Cst atus=<s t atus variable>3 

cat a logics This parameter specifies from which catalog all 
flies are to be deleted. Omission will cause 
the current working catalog to be used. 



status J 



See ERROR HANDLING. 



2.15.2 DI$PLAY_ACTIVE_TA$K ? DISAT 



The purpose of this command is to display task statistics for 
all currently active tasks in a job. The following information 
is displayed* 

task name 

execution time use 
number of page faults 

display_acti ve_task Coutput=<fi I e>3 

C sta tus-<s ta tus variable>3 

outputJo: This parameter specifies the file to which the 
task statistics is displayed. Omission will 
causa $ OUTPUT to be used. 
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2.0 COMMAND INTERFACE STATUS 
2.15.3 OISPLAY.SYSTEM.DATA I DISSD 



>WMJWW«fMMWWMlllirwWWWWWWWWWiWMWW«rWW«MMWMWNWWWJ 



2.15.3 OXSPLAY.SYSTEH.DATA 1 DISSD 

The purpose of this command is to display system page fault 
statistics and system monitor request statistics* 

display. system. data tdl splay. opt lon-page.f a : u I ts ! pf 

J ion i tor.r equests \ mr \ a I! 
Cdi sp I a y_ for mat* incremental * I .total * t3 
Coutput*<f I I e>1 
Cstatus a <status variable>3 

d isp ! ay.opt ion! do: This parameter specifies which 

statistics are to be displayed. The 
following options are allowed : 

page. faults - display the page 

fault statistics. 

monitor. reouests '- display the system 

monitor request 
statistics. 

Omission will cause ALL to be 

used. 

disp I ay.f ormat * df s This parameter specifies whether a 

display of the all statistics recorded 
so far (total) or only those statistics 
recorded since the last 
d i spl ay.system.data command 

(incremental) should he displayed* 
Omission will cause incremental to be 
used. 

output'o: This parameter specifies the file to 

which the system data will be 
displayed. Omission will cause SOUTPUT 
to be used. 

status: See ERROR HANDLING. 

2.15.4 OISPLAY.JOS.DATA \ OISJD 



The purpose of this command is to display the following job 
re I ated s tat i st i cs : 
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NW»MW«*MWMN*WMal«M*NNI«l«»WNM)«NWWWNMW«rWN«NM«MWttW««>WWI»«NM] 

2.0 COHHAND INTERFACE STATUS 
2.15.* 01SPt.AY_J08.DATA J OISJD 



time In Job node 
time in monitor mode 
count of page in operations 
reclaimed pages 

new pages assigned 
work! ng set size 
count of re ad y t a sk s 

display.job_.data C di spi ay_opti on- job_dat a 3 

Cdl sp 1 ay_f orm at s incremental J i J total J t 3 

CoutPUt=<flle>l 

€§tatus*<s tatus v<ariable>l 



di sp I ay. opt i on? do J 



d Isp !ay_f ormat I df 



output ! o J 



status i 



This parameter specifies which 
statistics are to be. displayed* The 
following options are allowed? 

job.data - display job related data. 

Omission Mill cause job.data to be 
used. 

This parameter specifies whether a 
display of the ail statistics recorded 
so far <total) or only those statistics 
recorded since the last d i sp! ay„ Job.dat a 
command i incremental) should be 
displayed. Omission will cause 
incremental to be used. 

This parameter specifies the file to 
which the job data will be displayed. 
Omission wilt cause SOUTPUT to be used. 

See ERROR HANDLING. 



2.15*5 DISPLAY.COHMAND. INFORMATION J DISCI 



The purpose of this command is to display current information 
about a NOS/VE command. The parameter names* abbreviations* 
allowed values and known problems for a command* as supported in 
the current system* can be determined. This is a nonstandard 
command and vail I be replaced by the help utility sometime in the 
future. 

di spl ay_command_i nf ormat Ion comm8nd_name 3s <name> * al I 
Cut i I i ty„nawe s cr eate.object. I i br ary * 
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2.0 COWHAND INTERFACE STATUS 

2.15,5 DISPLAY_CQMMAND_INFOP.MATION I DISCI 



col I sour ce_code_ut i ! i ty! scul system 1 
Cd Ispi ay_opt i on- par ameter.de scr ipt t on_tab ! e J 

pdt J notes J names 1 he I p3 
CoutPut s <f i le reference)! 
tstatus-<status variafole>l 

coamand.nameicns This parameter specifies the nape of the 

command about which information is to be 

displayed. 

uti I i ty.naraeSun: This parameter specifies which utility the 

command belongs to. Omission Mill cause 

SYSTEM to be used. 

di sp! ay.opt ionido* This parameter specifies the type of 

display being requested. The options are: 

par ametar_descr i p t ion_tab le ' pdt - selects 
a display of the parameter descrip- 
tion table used by the command when 
executed. 

notes - selects a display of any known 

problems with the command. 

names - selects a display of the .command 
names for a utility. 

help - selects a display of the command 
interface description of the command. 



Omission 



will cause PDT to be used. 



output Jo J 



status: 



This parameter specifies the file to which 
information will be displayed* Omission 

will cause SOUTPUT to be used. 

See ERROR HANDLING, 



2.15.6 CQNVERT.08JECT.FI16 \ CONOF 



The purpose of this command is to get a NOS/VE object file 

produced on NQS and to convert it to an object file suitable for 

processing by the NOS/VE loader or object code maintenance 
commands • 

conver t_ob ject.f i I e to=<file reference) 
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C f r om=<name>'3 

£user=<name>l 

Cst a tus~<sta tus variab1e>3 

to!t: This parameter specifies the NOS/VE file name on 
which the converted object file is to be written. 

from'f: This parameter specifies the name of the NOS file to 
be converted. This is the permanent file name as 
defined in the NQS file system and can be up to seven 

characters in length. 

Omission will cause the permanent file name of the 

TO parameter to be used. 

user'u! This parameter specifies the NOS user identification 
of the owner of the file. This parameter is only 
neccessary if the file is in a catalog other than the 
user who was specified by the most recently issued 

S£T_LINK_AT TRIBUTES command. 



status: See ERROR HANDLING. 



2.15.7 GET.Q8JECT.FILE 5 GETOF 



The purpose of this command is to get a previously converted 
NOS/VE object file from the NQS side and sets the appropriate 
file attributes that will allow the object file to foe used by 

NOS/VE. 

get_ob ject_f I I e to = <file reference) 

tfrom=<name>3 
Cuser*<name>3 
[status *<st at us var i abl e>3 



toSt: This parameter specifies the NOS/VE file name of the 
object file. 

from'f: This parameter specifies the NOS file name of the 

object file. This is the permanent file name as 

defined in NOS and can be up to seven characters in 

length. 

Omission will cause the permanent file name of the 
TO parameter to be used. 

user'u: This parameter specifies the NOS user identification 
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2.0 COHMANQ INTERFACE STATUS 
2.15.7 GET.08JECT.FILE t GETOF 



of the owner of the file* This parameter is only 
necessary if the file is in a catalog other than the 
user who Mas specified by the most recently issued 
SET.l INK. ATTRIBUTES command. 



status? See ERROR H4N0LI) 



2.15.8 GET.0BJECT.LI8RARY \ GETOL 



The purpose of this command is to get a previously created 

NOS/VE object library from the NOS side and set the appropriate 

file attributes that will alio* the object library to be used on 

NOS/VE. 

get.ob ject.l ibr ary to*<file reference) 

If rom x <naaie> J 
£user*<naflte>3 

Csta tus=<status variable>3 



toi t* 
from? f s 



This parameter specifies the 
object f i br ary« 



S/VE file name of the 



This parameter specifies the NOS file name of the 

object file. This is the permanent file name as 

defined in NOS and can foe up to seven characters in 

I ength. 

Omission will cause the permanent file name of the 

TQ parameter to be used. 

This parameter specifies the NOS user identification 
of the owner of the file* This parameter is only 
necessary if the file is in a catalog other than the 
user who was specified on the most recently issued 

SET. LINK. ATTRIBUTES command. 



status: Sea ERROR HANDLING* 



user J u * 



2.15.9 OISPLAY.OBJECT.TEXT \ PISOT 



The purpose of this command is to produce a formatted display 
of the object text contained in an object file or object library 
produced on NOS/VE. 



display.object.text fi I e«<f I 1 e> 
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£•15*9 DISPLAY_QBJ£CT_TEXT \ DISOT 
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Cou tput«<f I I e referenced 

Cstatus=<status variable>3 

f i I e * f 5 This parameter specifies the object file or object 
library containing the object text to be listed* 

output*©* This parameter specifies the file to which the 

display is to be written* 

Omission will cause the file SOUTPUT to be used* 
stat us s See ERROR HANDLING. 

2.15*10 GET.SQURCE. LIBRARY ? GETSL 

The purpose of this command is to get a previously created SCU 
source library from the NOS side and set the appropriate file 
attributes that will allow the source library to be used on 
NOS/VE. 

get.source.H brary to=<file reference> 

i f rom a <name>3 
[user-<name>3 
[ statuses tat us var i afo I e>3 

to'tJ This parameter specifies the NQS/VE file name of the 
source I i br ary • 

from*f! This parameter specifies the NOS file name of the 
source library* This is the permanent file name as 
defined in NOS and can be up to seven characters in 
I ength. 

Omission will cause the permanent file name of the 
TO parameter to be used* 

user'us This parameter specifies the NOS user identification 
of the owner of the file* This parameter is only 
necessary if the file is in a catalog other than the 
user who was specified on the most recently issued 
SET_LINK_ATTRIBUTES command. 

status: See ERROR HANDLING* 
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2.0 COMMAND INTERFACE STATUS 
2*15.11 £DIT_FILE J EDIF 

2a5,ll EDIT.FILE I EDIF 

The purpose of EDIT_FILE is to initiate the execution of the 

SCU editor on a text file. (For details see ARH3883.) 

edit. file * edit - edit lines on a source file* (procedure file 
not necessarily in its final form) 

BatamfilsLS dafaults 

f i le=f I let source) SREGUIRED 

tresul t«f i I e< source)] $VALU£(FIL£) 

Clnput*flle reference 1 $CQMMAND 

Coutput»f lie reference? SQUTPUT 
[status] 



2.15.12 JEOIT 



The purpose of this command is to initiate execution of the 
JEDIT editor built by Jack Bofinhoff. Anyone wanting information 

about the editor should contact Jack. 

jed It f r om-<f 1 1 e> 

[status =<status variable>3 

fromJfJ This parameter specifies the file to be edltted. 
This file is rewritten after the editor 
terminates* 

status? See ERROR HANDLING in the NQS/VE Command 
Interface • 



2*15.13 DE8UG 



The prototype Rl NOS/VE debugger Is now available. Details on 

how to use the debugger can be found in the "CYBER 180 
INTERACTIVE DEBUG External Reference Specification and User's 
Guide"* Sunnyvale DCS number $4028. 



Cycle 7. July-August 1982 



NOS/VE Cycle 7 Helpful Hints 

«• www m m mm m mm mm m m m -mm m m mm m mm m m .mm m mm m m m mm -m m mm m m m m mm mm- m mm-m m m ■■ 

2*0 COMMAND INTERFACE STATUS 
2*15.14 SET.LINK.ATTRIBUTES I SETLA 



2-16 



09/14/82 

r»*M«M««MN M M 4 



M *» M M M M i 
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2.15.14 S£T_LINK_ATTRI8UT£S X SETLA 



The SET_LINK_ATTRIBUTES command is the same as documented in 
the NOS/VE command interface with the exception that the CHARGE 
and PROJECT parameters are optional (and in fact not useful in 
the current environment since «e disable that feature on the MOS 
side). 
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3.0 PROGRAM INTERFACE STATUS 
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3.0 £&I3fi&Afl_ISI£££ACE-£IAIUS 



The 'status* column indicates whether the procedure Is 
unchanged from the previous build* modified from the previous 
build or not available in this build. Footnotes are numbered 

within each section. 



3.1 caflaAMfl-ESQUESSiafi 



ii£££&flUL£ 

CLP$3CAN_?ARAM_i.I$T 


unchanged 


CLPSTEST. PARAMETER 


unchanged 


0LPSGET_KEYWORD 


unchanged 


CLP$GET_SET_COUNT 


unchanged 


CLP$GET_VALUE_COUNT 


unchanged 


CLP$TEST_RANGE 


unchanged 


CLP$GET_VALUE 


unchanged 


CLP$CREATE_ VARIABLE 


unchanged 


CLP$DELETE_VARIABLE 


unchanged 


CLP$READ_VARIABLE 


unchanged 


CLP*WRITE_VAPIABLE 


unchanged 


CLP$SCAN_COMNAND_FUE 


unchanged 


CLP$END_5CAN_C0MHAND_FXLE 


unchanged 


CLP$SCAN_CQHMAND_LINE 


unchanged 


CLP$CREAT£_FILE_CONNECTION 


unchanged 


CLPJDELETE.FILE.CQNNECTION 


unchanged 


CLPSPUSH/POP.UTILITY 


unchanged 


CLP$GET._CONHAND_QRIGIN 


unchanged 


CLPSGET.DATA.LINE 


unchanged 


CLP$SCAN_PROC_DEClARATION 


unchanged 



3.2 a£SSA££-££!i£££iaE 
&Lfi££dU£& 

(3SP$F0RMAT_MES$AGE 

OS PSSET.STATUS. ABNORMAL 

OSP$APPEND_STATUS_PARAMETER 

QSP$A PP END.STATUS. INTEGER 



unchanged 
unchanged 
unchanged 
unchanged 
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3,0 PROGRAM! INTERFACE STATUS 
3*3 RESOURCE MANAGEMENT 

3-3 a££QU£a£.l*M&££M£MI 

R*!P$REGUEST.N ASS. STORAGE unchanged 

RMPSREQUEST.TSRMINAL unchanged 

All terminal attributes can be specified on the 
RMPSREQUEST.TERMINAL call but only the following are operational! 

o auto. Input 

o trans parent. mode 

o pro flip t.f i I e 

o promptest!* i ng 

Files assigned to a terminal device can be accessed via the 
following 8AH requests: 

AN?$0PEN 

o AMPSGET.NEXT 

o AMP$GET. DIRECT 
o A?1P$GET. PARTIAL 
o AMP$PUT_NEXT 
o AMP$PUT.OIR£CT 
o AMP$PUT_PARTIAL 
o AflP$CLOSF 
o AHPSREWIND 
o AHP$SKIP 
o AMPSSEEK.DIRECT 

3.4 £&flfi&A2!-£X££UII0tJ 

PMPSEXIT unchanged 

PMP$EXECUTE unchanged 

PHPSTERHINATE unchanged 

PMP$AWAIT_TASK_TERMINATIQN unchanged 

PMPSMOQULE.T ABLE. ADDRESS unchanged 

PMP$ENTRY.PQINT.TA8L£.ABQRES$ unchanged 

PMPSPUSH.TASK. DEBUG. MODE unchanged 

PMP$SET_TASK.DEBUG.MODE unchanged 

PMPSTASK.DEBUG.HGDE.ON unchanged 

PMPSSET.DE 8UG.RING unchanged 

PMP$DEBUG.RING unchanged 

PMPSCHANGE.DEBUG.LIBRARY.LIST unchanged 

PMP$ POP. TASK.0E8UG. MODE unchanged 
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3.0 PROGRAM INTERFACE STATUS 
3,5 PROGRAM COMMUNICATION 



3.5 £EO£EM-XQMyMI£AIIGM 



£££&£J2U£S 




SiJiiis 


OSP$AWAIT_ACTIVITY_CGMP 


LETION 


unchanged 


PHPSDEFINE.QUEUE 




unchanged 


PHPSREHOVE.QUEUE 




unchanged 


PHP$CONNECT_OUEUE 




unchanged 


PNPSDISCONNECT.QUEUE 




unchanged 


PMPSSEND.TO.QUEUE 




unchanged 


PMP$RECEIVE_FROM_QUEUE 




unchanged 


PHP$STATUS_ QUEUE 




unchanged 


PHPSSTATUS.QUSUES.DEFINED 


unchanged 


PMP$GET.QUEUE.LIMITS 




unchanged 



3.6 £.0MIIIfllL.££O£E££i£i£ 

E£fifi£dU££ 

PMP$ESTABLISH_CONDIT ION. HANDLER 

PNPSDISESTABLISH.COND.HANDLER 

P*P$CAUSE_CONDITIPN 

PMPSCQNTINUE.TO.CAUSE 

PMPSTEST.CONOITION.HANDLER 

P**P$VALIDATE_PREVIQUS_SAVE..AREA 

PMP$ESTA8LISH_DEBUG_0FF 

OSP$SET_STATUS_FROH_€t}NDITION 



Added support of detected 

uncorrected error 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 



3.7 £RflfiEAtt.S£&liI££S 
£r.&££*Juxe. 

PHP$GENERATE_UNIQUE_NAME 

PMP$GET_TIME 

PMP$GET_M I CR OS ECQND.CiaCK 

PHPSGET.TASK.CP.TIME 

PMP$GET_DATE 

PHP$GET_USER_IDENTIFICATQN 

PHPSGET.ACCQUNT. PROJECT 

PMP$GET_JOB_NA?1E$ 

PMPSGET.JQB.ID 

PMP$G£T_JOB_MQDE 

PNP$GET_PROGRAN 

PHPSGET.TASK.ID 

PMPSMANAGE.SENSE. SWITCHES 

PNP$GETJDS_VERSION 



SlalUS 



uncha 
uncha 
uncha 
uncha 
uncha 
u n c h a 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 



nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
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3.0 PROGRAM INTERFACE STATUS 
3,7 PROGRAM SERVICES 

A# 4W M A» M M 4W M .*» .M A> .M M M »* -M M 4W Mr «w M -M AT M «r .M AT ,W M M M 4W AT M M M> M «T Mr .M JW M M .M M JW -M M> 



M .*» M M M <W M M M M M tttMimiMMMmitmtmt 



PH PSGET.PROCESSQR.ATTR I SUTES 
PHP$DEFINE_DEBUG_ENTRY 
PN?$GET_DEBUG_EMTRY 
PHPSNOD I FY_DE8UG_EN TRY 
PMPSREMQVE.DESUG.ENTRY 



unchanged 
unchanged 
unchanged 
unchanged 

unchanged 



3.8 LflfifilMfi 



PMP$L0G 
PMPSLOG. 



.ASCII 



unchanged 

unchanged 



3.9 £IL£.MAHAfi£H£I.I 
ELAfi&dULfi 

Sequential Access 
Byte. Address able Access 
Record Access 
Segment Access 

V. System Specified 

V_User Specified 

U.System Specified 

U_User Specified 

F_System Specified 

F_User Specified 

AMP$DESCRIBE_NEW_FILE 

AHPSFILE 

AM P$GET_FILE_ ATTRIBUTES 

AMP$FETCH 

AHPSSTQRE 

AMPSCQPY.FILE 

AMP$RENAME 

AMP$RETURN_FILE 

AMP$QPEN 

AftPSCLOSE 

AM P$FETCH_ACCE5S_INF OR NATION 

AMPSSKIP 

AMPSREWIND 

AMP$WRITE_END_PARTITIQN 

AMPSGETJ4EXT 

AMPSGET. DIRECT 

AMPSGET.PARTIAL 

AHPSPUT.NEXT 

AMP$PUT_DIRECT 

AMPSPUT PARTIAL 



St-Slys. 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

deleted 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

new name 

unchanged 

unchanged 

unchanged 

unchanged 

*2 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 



- *1 



- *3 
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3,0 PROGRAM INTERFACE STATUS 
3,9 FILE MANAGEMENT 

AMPSSEEK.DIRECT unchanged 

AMPSGET_SEGMENT_PQINTER unchanged 

AMP$S£T_S£GM£NT_EOI unchanged 

AMP$S£T_SEGMENT.POS ITIQN unchanged 

AMPS SET.LaCAL.NAME. ABNORMAL unchanged 

AMPSS ET_F I LE_IN STANCE. ABNORMAL unchanged 

AMPS ACCESS. METHOD unchanged 

AHP$F ETC H.FAP.PO INTER unchanged 

AM PSS TORE .FAP. POINTER unchanged 

*1 Segment access If a segment access file is written and an 

AMPSSET.SEGMENT.EOI is not issued to record the EOI* EQI 
regains zero. The highest page referenced is not yet used as 
the default EQI, This particularly affects those who wish to 
make heaps permanent because EOI is always zero for a heap* 

*2 AMP$REWINO The WAIT parameter on the procedure call is not 
suppor ted, 

*3 AMP$PJT_*ARTIAL PUT.PARTXAL with the TERM.QPTION 

AMCSTERMINATE does qo.£ act as a put.next if a preceding START 
was not issued, 

3,10 ££&flAli£fclI_£IL£-flAfcUfi££iEiiI 

ELac.e.StU££ StJiUS 

PFPSDEFINE unchanged 

PFPSATTACH unchanged 

PFPSPURGE unchanged 

PFPSCHANGE unchanged 

PFPSPERMIT unchanged 

PF PSD EL ETE.PERMIT unchanged 

PFPSDEFINE.CATALQG unchanged 

PFPSPURGE.CATALOG unchanged 

PFPSP ERMIT.CATALQG unchanged 

PFPSOELETE.CATALOG. PERMIT unchanged 

3*11 fl£HaBX.tlA!!lAfi£Sl£I4I 

MMP$ ADVISE. IN unchanged 

MM PS ADVISE. OUT unchanged 

MM P$ AD VISE. OUT. IN unchanged 

IMPSWRITE.MGDIFIED.PAGES unchanged 

MMPSC RE ATE. SEGMENT unchanged 

MMPSDELETE.SE GHENT unchanged 

MM P$ S TOR E.SEGMEMT. ATTRIBUTES unchanged 

MMP$FETCH_S£GM£NT.ATTRXSUTES unchanged 
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M«tt*>NW«M«>WW«MI««N*rWI)W*«M«WWWWM«IV«rNW««iyM«liril«r««WMW*Wi 



MMPSVERIFY.ACCESS 
MMPSFREE 

MMPSLOCK. PAGES 

MMPSUNLOCK. PAGES 

MM PSFETCH.PVA.UN WRITTEN. PAGES 



unchanged 

unchanged 

number of locked pnges per 

segment restricted to 32 

unchanged 



3.12 SIAIISII£S-EA£ILm 

SFP$ESTABL IS H.ST ATI STIC 

SFP$ENA8LE. STATISTIC 

SFPSDISABLE. STATISTIC 

SFPSDISESTABLISH.STATISTIC 

SFP$EHIT. STATISTIC 

SF PS EM I T.SYSTEM.STAT IS TIC 



unchanged 

unchanged 
unchanged 
unchanged 
unchanged 
unchanged 



3.13 IBIfiBAHmfi-EaCILill 

IFPSTERMINAL unchanged 

IFPSFETCH.TERHINAL unchanged 

IFPSSTQRE.TERMINAL unchanged 

IF PSGET.DEFLT.TERMINAL. ATTRIBUTES unchanged 

IFPSGET. TERMINAL. ATTRIBUTES unchanged 

IFPSADVAHCE new - *1 

*1 Only the option IFCSAOVANCE.ALL.CUEUE D.OUTPUT is supported. 



3.14 tiQiIM£-£i£££IIQIlS 



The following summarizes the exception code ranges currently 
assigned to NOS/VE. These code ranges represent a finer 
breakdown than the one specified In the SIS for internal NQS/VE 
development purposes. However* it is important to remember that 
only the product identifiers documented In the SIS may appear in 
error messages. 



Common Modules 
Common Code Generator 



9 #000 - 9*999 
8 #000 - 8*999 
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Product 




Exception 


Coda 


Identifier 


Product Name 


1 - 158 


*999 


Reserved 




159*000 - 


159*999 


SY 


System Core 


160*000 - 


169,999 


AH 


Basic Access Methods 


160*000 


- 163*999 


BA 


Basic Access 


164*000 


- 164*999 


LN 


Local Hate Mgr 


165*000 


- 165*999 


JF 


Job File Mgr 


166*000 


- 166*999 


SR 


Conversion Services 


167*000 


- 167999 


CM 


Configuration Hgmt 


170*000 - 


179*999 


CL 


Command Language 


180*000 - 


189,999 


JH 


Job Management 


190*000 - 


199*999 


LL 


Loader 


200*000 - 


209*999 


MM 


Memory Management 


200*000 


- 204*99 9 


MM 


Monitor Level 


205*000 


- 205*999 


MM 


Task Level 


210*000 - 


219*999 


OS 


Operating System 


210*000 


- 210*999 


OS 


OS 


211*000 


- 211*999 


MT 


EXEC 


212*000 


- 212*999 


10 


MS I/O 


213*000 


- 213*999 


in 


Tape I/O 


214*000 


- 214*999 


DM 


Device Management 


215*000 


- 215*999 


ML 


Memory Link 


216*000 


- 216*999 


IF 


Interact i ve 


217*000 


- 217*999 


TM 


TM Monitor 


218*000 


- 216*999 


TM 


TM Task 


219*000 


- 219*999 


JS 


Job Swappers 


220*000 - 


229,999 


PF 


Permanent File 

Management 


221*000 


■ - 221*999 


ST 


Set Management 


222*000 


- 222*999 


PU 


Permanent File Utilities 


230*000 - 


239*999 


PH 


Program Management 


240*000 - 


249*999 


RM 


Resource Management 


250*000 - 


259,999 


QF 


Operator Fac i I i ty 


260*000 - 


269*999 


AV 


User Administrator 


270*000 - 


279*999 


IC 


Interstate Communication 


280*000 - 


289*999 


RH 


Remote Host Facility 


290*000 - 


299*999 


OC 


Object Code Utilities 


300*000 - 


309, 999 


DB 


Deadstart/Recovery 


310*000 - 


319*999 


MS 


Maintenance Services 


32 0*000 - 


329*999 


Reserved 




340*000 - 


349,999 


SF 


Stat i st i cs Fac* 


330*000 - 


339*999 


US 


User Errors 


500*000 - 


509*999 


AA 


Advanced Access Method 


510*000 - 


519*999 


AG 


ALGOL 


520*000 - 


529,999 


AL 


Assembly Language 


530*000 - 


539*999 


AP 


APL 


540*000 - 


549*999 


BA 


BASIC 
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530*000 
560,000 
570*000 

580*000 
590*000 
600*000 
610*000 
620*000 
640*000 



559*999 
569*999 
579*999 

589*999 
599, 999 
609*999 

619,999 
629*999 
649*999 



CA 

CY 
FT 

PA 
PI 

$n 
sc 

DB 



Conversion Aids System 

COBOL 

CYBIL 

FORTRAN 

PASCAL (yirth) 

PL/1 

Sort Merge 

Source Code Ut i I I ty 

Debug 
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4*1 £U£B£fclI-ailAL-SIAI£_£flt4£IfiU£AIIDIi 

The Arden Hills $2 development systems are configured to run 
with three F,MD units* 

o FMD Unit 43 

This unit contains NOS permanent files* 

o FHD Unit 41 

This unit contains the following? 

Files required to deadstart dual state Cycle 5? A 170 NQS 
(5*3 plus changes necessary for Cycle 5)> CTI* HSL* £1 
binaries* and NOS Da ads tart files* 
- It is also used as a temp device. 

o FHD Unit 42 

This unit contains NOS permanent files* 

o FHD Unit 44 

This is another NOS PF device* 
o FMD Unit 45 

This is another NOS temp device* 

4*2 US£&JiA&£S-Alifi-££BflAi!EHI_EILES 

1) The convention used for creating user names on NOS/VE Is as 
fol lows s 

o Your user name will be your initials* 

o Your password will be these 3 letters followed by the 
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4.0 DUAL STATE DEADSTART AND OPERATION 

4,2 USER NAMES AND PERMANENT FILES 



x3092) to be 



letter * x • * 

o You must see CQHSQURCE (R.K. Cooper * 
assigned a user index 

2) PF dumping and loading 

You may use M SES. DUMP PF M on SN/101 to dump your permanent 

files to tape* and then load them onto your user name on A170 
NOS using "SES.LOAOPF". Documentation on how to use these SES 

procedures and what their parameters are is included in the 
SES User's Guide* or they can be obtained by typing! 

SES, HELP. DUMPPF and SES>HELP .LOAOPF . 



4 . 3 IQ_&ELQAJJ_CQ!!iI£aLa^&£-Efl£-Iti£_fcmm£-fiISK-aRmR 



At deadstart time MOS will automatically load 7155-lx disk 
controiuare on one channel with controller type*FM (ISC CMRdeck 
entry)* and Hill automatically load 7155— 4x disk controlware on 
any channel with controller type=HT CL8C CMRdeck entry). NOS/VE 
supports both of those types of controllers. NOTE: It is not 
possible to use 844 half-track controlware in this environment* 



4.4 Alia-aQS-flfiADSIA&I 



4.4.1 CTI AND CHECKING CENTRAL MEMORY 
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4.0 DUAL STATE DEADSTART AND OPERATION 

4,4*1 CTI AND CHECKING CENTRAL HENDRY 

user each morning) then the HIVS program should be run* This is 
ace omp i i shed by 2 

1) deadstart to NOS/VE (unit 40 for S3* unit 41 for S2) 

2) Enter (operator intervention! 

3) Enter P (deadstart panel*make sure level deadstart) 

4) <8KSP> 

5) Enter H (assure yourself that CS*Y£S to reload microcode) 

6) <BKSP> 

7) Enter V (verification sequence) 

8) Hit <CR> at 'parameter display* to test CM £ Q? 

Mhan you see text that tells you that verification is complete 
and a deadstart is required* you are now ready to deadstart NOS* 

4.4,2 NOS DEADSTART 



See Section 3.3 of the Integration Procedures Notebook for 
important NOS CNPOECK changes, 
Set the D/S panel to deadstart fro& the primary system disk. \ 

This is Unit 41 for ail Cycle 5 systems. » 

Push D/S button 
o Enter (CR) 
o Enter date/time 

Wait for deadstart to complete. 

Mote: The deadstart tape DUALS (which is currently Installed on 
unit 41) is found in the area in the northeast corner of the S2 
lab where the tape cabinet Is found. 



4. 5 JiQSZJl£-aEAQilARI_AHa-IliSIALLAIIQfl 

Enter DQWN*CH2« so NOS/VE can use the channel. 
Enter D0WKbCH32. so NOS/VE can use the channel. 
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4*0 DUAL STATE DEADSTART AND OPERATION 
4*5 NOS/VE DEADSTART AND INSTALLATION 

o The following file must be available in your catalog on the 
S2J 

TPXXXK contains a NOS/VE deadstart image* This must foe a copy of 
the dual state deadstart Images available from the link 
procedures* 

o If you've never deadstarted NOS/VE from the user number from 
which you want to run or if you wish to change the current 
parameter settings for your particular user number* then do a 
SETVE* SETVE assumes the file TPXXXK is in your user number J 
you do not have to do another SETVE if TPXXXK has changed 
since the last time you ran. The general form of SETVE I s • 

X.SETVE(PN»ff ff.UN«un»C*6) 

where ffff is an identifier of up to 4 characters and un is 
the user number to search first for files* 6 is the number of 
the system core command deck for the Arden Hills 52 
con f i g ur at i on . MflLflinfll-Sfififiif xi0Sl-Cs6-fia-.ttlS.A£iiaa-tlillS_S3 
Miii-dfiSti:fl^-ii2fi-CiilSfli1-.*illflfi-fifi£fflaQfiQt-lilft-iiasfi*- In general 
ffff and un will be the same* e.g. X«SETV£(DAH»UN»DAH.»C«6) 

♦♦Only ONE SETVE should fee done for each user number and a 
SETVE should HOT be done for ANY Integration user number 
except by the Integration project*** 

SEE SECTION 5*1 FOR MORE DETAILS. 

o Bring up dual state: 

NVEffff. 

where ffff is the identifier specified in SETVE* e*g* 
NVEINT1* 

o Bring up the Operator Facility 

Enter K..NVE. 

NOS/VE is currently generated and initialized on both NOS 
and NOS/VE* All source and object libraries that make up the 
NOS/VE system are produced on NOS and therefore must be 
converted from their CI to II counterparts* Other parts of 
installing and initializing the system {e*g* building the 
SSYSTEN catalog) are performed by command language procedures 
on NOS/VE* Since the same system will many times in a closed 
shop environment* it is advantageous to only perform the 
conversion from CI to II a single times save the results in 
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4,0 DUAL STATE DEADSTART AMD OPERATION 
4*5 MOS/VE OEADSTART AHO INSTALLATION 



MMMMMMMMMMMMMMMM M *t M M M M W 



the NOS file system 
dur ing deads tart* 



and then simply bring the files back 



The actual files that get installed and loaded on each 
deadstart are determined by a command language procedure (the 
system profile) interpreted on NOS/VE* This procedure can be 
modified by each site to initialize their NOS/VE environment 
In the wost suitable fashion* The process of building the 
system profile and of performing the CI to II conversions is 
referred to as an installation deadstart and the process of 
executing the system profile and of fetching previously 
converted files from NOS and making them available in the 
NOS/VE file system is referred to as a deadstart. A single 
command is available to perform both an installation deadstart 
and a deadstart. 

4,5,1 THE DS PROCEDURE 

The purpose of this command is to perform an installation* 
normal or recovery deadstart of NOS/VE. The defaults for 
parameters are those most convenient for "closed shop" 
deadst arts • 

The procedure "brings up" the job log display on the left 

screen where the progress of the procedure may be watched* and 
the control point display on the right screen. Just before 
the procedure completes it changes the left screen to display 

the system log and writes to that log the message: 






Deadstart Completed * 



at which point the operator may enter commands. 



ds Ckind 3 install * normal * recover! 
[get_source_libraries=<boolean>3 
Cge t .products* < boo I ean>3 
Cecho=<boo 1 ean>1 

£ a I t e rn a t e_us e r - < N 05 _ us e r _ n a m e> 1 
Csave - install_files-<booiean>] 
Iva I idate_users*<boolean>3 
Cgui ck_val i date* I i st of <name>3 
tdebug~<boolean>3 
Chelp s: <file referenced 
Cstatus*< status variable>3 



kind * Hi This parameter specifies what kind of deadstart is 
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to be performed. 



lid specifications are? 



install * i - installation deadstart to be performed* 
The system libraries are built from CI object 
f I I e s . 

normal i n — normal deadstart to be performed* The 
system libraries are obtained from the results of a 
previous installation deadstart* 

recover \ r - recovery deadstart* Just initiates system 
tasks* Permanent files are "recovered** froia a 
previous run of the system. 

Omission will cause a recovery deadstart to be 

per formed* 

get_source_l i br sr » es \ gsl: This parameter specifies whether 
SCU libraries are to be installed* Valid specifications 

are* 

true I yes £ on - libraries are to be installed 

false 1 no J off - libraries are not to be installed 

On the Arden Hills closed shop S2 system* the SCU 
libraries to be installed ares 

OSFPIL -> nSFSPRGGRAM.INTERFACE. LIBRARY: operating system 
program interface 

OSFSL -> OSFSSOURCE.LIBRARY* subset of operating system 
source I ifor ary 

Omission will cause SCU libraries to be installed* 

get. products S gp: This parameter specifies whether the object 
libraries defining the current product set are to be 
installed. Valid specifications ares 

true ] yes » on - the products are to be installed 

false \ no 1 off - the products are not to be installed 

On the Arden Hills closed shop S2 system* the product 

set to be installed consists of? 

CYFIIC -> CYFSCOMPILER: cybil II compiler 
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CCFRTL -> CCF$RUN_TIM£.J.IBRARY: common compiler modules 
run time library 

MLFRTL -> HlF$RUN_TItfE_LIBRARY: math run time library 

DBFDL -> 08F$0E8U6.LI8RARY* symbolic debug library 

SCFOL -> SCF$Q9JECT_UBRARY: source code utility 

SCFCL -> SCF$C0MMANDJLI8RARY: source code utility 

"stand-alone" command library 

IFFSDIT -> IFFSEDITOR: Jack Bohnhoff's editor (JSDIT) 

Omission %*ill cause the product set to be installed. 

echo * e: This parameter specifies whether the commands should 
be echoed to the console during execution. Valid 
speci f i cat i ons are J 

true \ yes \ on - echo commands 

false \ no \ off - do not echo commands 

Omission will cause commands not to be echoed. 

al ter nate.user \ au: This parameter specifies what NQS user to 
check if the default NVE user does not have the needed 
file. Any NOS user name is allowed. 

Omission will cause INT1 to be used. 

save.i nstai i_f i ! es J sifJ This parameter specifies whether to 
save the system libraries created by an installation 
deadstart. This parameter is ignored for a normal or 
recovery deadstart. Valid specifications are: 

true ' yes \ on - save the installed system libraries 

false » no « off - do not save the installed system 
libraries 

Omission will cause the files not to he saved. 

vai idate_users \ vu: This parameter specifies whether to run 
the job that validates NOS/VE users. This parameter is 
ignored for a recovery deadstart. Valid specifications 
ares 
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4.0 DUAL STATE DEADSTAPT AMD OPERATION 

4.5.1 THE OS PROCEDURE 

true \ yes J on - run the validation job 

false * no ; off - do not run the validation job 

Omission will cause the validation job to be run. 

qu!cK_val I date I qvs This parameter determines which users 
Mill be validated by the validation job if It is run. 
When specified; this parameter gives a list of user names 

to be validated in addition to the users? XNT1* INT2* 
DEVI; 0EV2; REll* EVAL and RKC. 

Omission hi I I cause all users to be validated. 

debug \ d: This parameter specifies whether the procedure 
should abort if an error condition is detected. Valid 
specifications are: 

true J yes 5 on - do not abort on an error. The user 
will be prompted for commands in the event of an 
error at which time entering "continue** will cause 

processing to resume* 

false J no » off - abort on an error 

Omission will cause the procedure to abort when an 
error is encountered* 

help \ h: This parameter specifies whether help information is 
to be written. If this parameter is specified* the help 
information will be written to the specified file and the 
procedure will terminate* 

Omission will cause the procedure to execute and the 
help information not to be written. 

status? See ERROR HANDLING in the NOS/VE ERS. 



If you change any of the following decks you MUST use the 
installation deadstart from your own catalog (with files 
CYBILSO. XUOCM* XLJQSL and XLJLI8); or you must use the 
al ternate.user parameter to specify a NGS catalog containing 
the f i les (e.g* DEVI). 

AVMUTIl CLHDP DMMDISA ICHCLOS ICBFAI ICHFAPC ICHFUSH ICHGET 
ICMOPEN ICHPUT ICMWEOP IFMEXEC IIMA72H IIHDC2S IIHRLE 

IIHRSE IIHRUM IIMRUSM IIMTDEL QCMADD QCMBIH QCH8IM OCMCOL 
OCHCOM OCMCPY OCHCRM OCHOEf OCHOEL QCMDLB GCNQNl 
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4,0 DUAL STATE DEADSTART AND OPERATION 

4*5. 1 THE OS PROCEDURE 

OCHDQL OCHEND OCHGEN QCMLCH DCNLHG OCNLP QCMHUR 

OCHNP QCH08J OCMtlFH 0CH0HS GCKRCH DCHRED OCHREP 0C«RMB 

OCHSAT OCBSOL OCHVEi OCPVLU OCHVDL PFHDC PFHTALL 
PUM8CAT PUMBCYC PUM3FIL PUHBFO PUMBLST PUMSPF PUMBSET 
PUNCOHN PUMCRAK PUMPURG PUMCRAK PUMIQBF PUHLIST PUMHISC 
PUNPURG PUMRALL *>UHRCAT PUNREC PUMREF PUHRFIL PUHRPF 
PUHSTU8 RHMLML RHHQAT RHMQQP RHMQRE PHHSFM USORT UTMOUR 

UTHPC1 UTMPC2 UTMPC3 UTHPC4 UTMPC5 UTMTSA UUSER1 



4*5,2 EXAMPLE OF ^QS/VE INSTALLATION DEADSTART 

Type 

K*NVE. 

K.SETLA (your_un?NVE ) your. password 

K.GETF DS U«scat 

K.DS INSTALL GSL=NQ GP*N0 AU*scat 

4.5.3 EXAMPLE QF NQS/VE "NORMAL" DEADSTART 

The Integration system has had the installation deadstart 
run on it. Also the files produced by the installation 
deadstart have been made seni-pr i vate and are found on the 
catalog used in the NVExxxx call* 

Type (where DEVI Is the same as the xxxx in the NVExxxx 
cal II : 

K. NVE. 

K.SETLA (DEVI, NVE) DEV1X 

K.GETF DS 

K.DS NORHAL 

4.5.4 EXAMPLE OF NQS/VE RECOVERY DEADSTART 

This is the kind of deadstart that should roost frequently 
be done in a "closed shop" environment and consequently is the 
one for nhich all the parameter defaults are oriented. It 
presupposes that permanent file recovery has been successful. 

Type (where DEVI is the same as the xxxx in the NVExxxx 
cal I) s 

K.»NV£. 

K.SETLA (DEVI, NVE) DEV1X 

K.GETF DS 

Cycle 7? July-August 1982 



NOS/VE Cycle 7 Helpful Hints 



4-10 



09/14/82 



WN«WWN«lltNW«l**W*WW«N***NffW«4MMHN««MN«INMWNI««««(««MM«IINMI(lfl 

4,0 DUAL STATE DEADSTART AND OPERATION 
4,5.4 EXAMPLE OF NOS/VE RECOVERY DEADSTART 



K.DS 



4.5.5 EXAMPLE OF MINIMAL NOS/VE DEADSTART 



The minimal deadstart shown below may be useful to OS 
developers who need to get the system up quickly and do not 
need the product set or all validated users. 



Type 

K»NV£. 

K.SETLA f your_un*NVE) your. password 

K.GETF OS IMscat 

K.DS NORMAL GSL=N0 GP=N0 QV*ycur_un AU*scat 



4.5.6 USE OF THE QUICK.DEAOSTART COMMAND 

This command is intended as a development tool to 
facilitate 'fast 1 deadstarts where recovery is not needed; 
indeed* If this command is entered ££££¥££.1 &LLL~nQ£-h£ 

2££ffi£li*M when- the system is brought down for whatever 
reason. Specifying this command will cause an ' ins tat I at ion 
deadstart to take place. If the INITOO command is not 
specified then a default value of • VSNOOl* is used for the 
system deadstart device. Use of INITOO will allow setting the 
deadstart devices identifier to any value. THIS COMMAND MILL 
NOT 8E ACCEPTED FROM A DEADSTART COMMAND FILE, SO »D»T« MUST 
BE SPECIFIED ON THE SETVE PROCEDURE TO PERMIT ENTRY OF THE 
QUICKDS COMMAND, 

Format: QUICKCS or QUICK.DEADSTART 

Values! The default is false. Executing this command 
causes this initial value to be toggled* thus executing this 
command twice will cause the final value to be false. 

Note: QUICK_TEMPLATE_LQAD does not exist now. 



4 . 6 mm_iMI£RA£m£-£ACILin-aPE&flIIOM 



4.6.1 OPERATOR INITIATIOI 



To bring up the MQS / VE 
f o I lowing: 



interactive facility do the 



1) 8r ing up NOS/VE. 
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4.0 DUAL STATE DEADSTAPT AND OPERATION 
4*6.1 OPERATOR INITIATION 

2) 8r ing up NAM 

At the system console enter J 

FCN*5#7700. ! 

NAHV2. for S2 and S3 \ 

31 If IAF is not up at control point 1, enters 
IAFV2. 

4.6.2 OPERATOR TERMINATION 

To terminate NOS/VE interactive any of the following may be 
done: 

- CFO#NAN.DI*AP«VEIAF. I 

This is the preferred method. To bring NOS/VE interactive * 
back upf you must first do a €F0»NAM*EN» AP-VEIAF. \ 

CFQ,NAH.DI>NE. ? 

This terminates the entire network including IAF*RBF* etc. 

4.6.3 OTHER OPERATOR CAPABILITIES 

- To logically turn the printer on» under DSD enters 

ON, 33. I 

F0RM>33»TM#. ! 

- To send a "shutdown warning** to all terminals logged on to * 
VEIAF do: S 

CFOjNAH.ID, AP=VEIAF. ! 

To send a message to all terminals do: 

CFO#NAf-WMSG» ALL, message. \ 

- PASSON has the ability to record various types of 
diagnostic information. This capability is controlled via 
the sense switches at the PASSON control point. To turn a i 

sense switch on (off) at job jsn do! I 
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4.0 DUAL STATE DEADSTART AND OPERATION 
4.6.3 OTHER OPERATOR CAPABILITIES 

ONSW>Jsn»x« <QFF$y, jsn*x. ) S 

where x is the desired sense switch (1 to 6}# The PASSON I 

default is all sense switches off* It will take a short J 
period of time before PASSON detects a change in a sense 

switch and reacts to it. The sense switches currently used ' 

by PASSON arm \ 

£MJL££iS-f US£ 

1 Network Trace 

2 PASSON Logic Trace To Dayfile 

3 Memory Link Trace To Dayfile 

4 . 7 MQ^^£-0££EAlQg^£4aiLII^^IiQ-QE£E4IQE.£aMMIi r 2S 

iith the release of the Operator Facility Phase 1 several 
changes to the NOS/VE Operating System will occur that will 
effect the users of the NOS/VE Operators Console. The 
Operator Facility runs as part of the NVE control point* When 
the request for K display appears on the NOS B Display* assign 
the K Display to the NVE control point. The Operator Facility 
is capable of displaying both a left and a right screen area 
at the same time. If the operator wants both screens then 
type in KK • The contents of these displays are determined by 
the commands entered by the operator. 

The left screen is diyided into four different areas. The 
top most area is the system header which contains the current 
date and time* memory statistics* and an operator action 
message if one is posted. The operator action will include 
the job sequence number of the owner of the message and 
f message cancelled 1 if the message is cancelled because the 
task has terminated. The next line contains the first 64 
characters of the operator action message {60 characters in 
stand alone). 

The next area of the screen is the wain output area. This 

area has the file name of OUTPUT. Any display command can 

have its output directed to this area as well as any system 
command. 

The third area is towards the bottom of the screen. This 
area is two lines long and contains the response area* This 
will contain error messages from system commands. The area is 
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NMWMWNWWWWWW 



cleared when the next operator type in is entered at the 
operator *s console and received fey N0S/VE« 



The fourth area is the prompt area* This n i 1 1 contain the 
status of the keyboard. If NOS/VE is processing a command* 
then the keyboard is locked and all typeins will be ignored* 

yhen the keyboard is locked* the message 'data received by 180 
- keyboard locked 1 nil I bppbbt at the screen's bottom* When 
the keyboard is unlocked then any data in the keyboard buffer 
Hill be sent to NOS/VE* The bottom line is the last line that 
was. processed by Operator Facility* 



The right K Display has the file name OUTPUT. RIGHT. There 
is only one area on the right screen therefore the main 
display area is 10 lines longer than the left screen area. If 
a dayfile display or CP display is shown on the right screen 
you wi II get more lines of information than on the left 
screen • 



There are no default displays that come up automatically on 
either output display area* It is up to the operator to 

decide the display the operator wishes to see. The only parts 
of the display that come up automatically is the system header 
display and the prompt area for keyboard status* 



The page width of the screen 
standalone and 64 characters for dual 
set translation code is the saie as 
Subsystem control point. The escape 



is 60 characters for 

state* The character 

that for the current NVE 

code sequence for the 



special characters to be typed has not changed* There are a 
few differences in the processing of data by the Operator 
Facility and NVE Subsystem* 

1) Do NOT end commands with a period* Periods are sent to 

NOS/VE. 

2) The NVE subsystem commands that begin with an asterisk Mill 
not be supported from the Operator Facility control point. 
If these commands are entered from the Operator facility 
they fcHII be passed on to SCL «here an illegal command will 

be issued* 



3) Routing of console job data to a specific 

•H-command* protocol will not be supported 
This feature should work in standalone but 



job by the 
n dual state, 
will not be 
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4.7 NOS/VE OPERATOR FACILITY AND OPERATOR COWHANDS 

supported* 

4) No type ahead - commands cannot be entered until the prompt 

area shows that they are requested. 



There is one new command to replace the current display 
commands* The entry points for Zdis* Zdlsb* and Sdls have 
been deleted. The new command Is VEDISPLAY and has two 
parameters. The options are listed below. The values In 
paranthesis are the abbreviations. Note that this command 
does not begin with an asterisk (*). This command will be 
processed by SCL and create a new system control point task to 
display it's data. The user can have the same display type on 
each of the display areas • If the user so desires. 



Command Name 



Display Typ> 



Screen Area 



Parameter Name 

DISPLAY. OPTIONS 
DISPLAY.OPTIOM <D0) 



Parameter Name 
OUTPUT (0) 



Parameter Values 



Parameter Values 



VEDISPLAY (VEQ) OISPL AY.SYSTEH.LOG OUTPUT 

JOS. LOG (41) OUTPUT. RIGHT (OR) 

CONTROL. POINT CCP) 



The default file name for ail displays is OUTPUT. 

The following is a brief list of commands to bring up NOSVE 
with the Operator Facility installed. 



NVEfff f . 

K.NVE. 

KK. 



to bring up NOS/VE. (See Section 5) 

to bring up the K display on both screens. 
to bring up the job log. 



K.VED JL 
or 

K.VED DISPLAY. 0PTI0NS*JL OUTPUT-QUTPUT 

to bring up the job log using key word 
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identifiers* 

K.VED CP OUTPUT.RIGHT 

to bring yp the control point display on 

the right screen, 
or 
K.VED DISPLAY.OPTiaNS=CONTRQL. POINT OUTPUT»OUTPUT_RIGHT 

to bring up the control point display using 

key word 

identifiers. 



K . xxx 



send any command to NOS/VE. 



K. TERMINATE SYSTEM 



to terminate NOS/VE* 



Note: After the OS procedure has completed execution the 
command to enter to bring down the system is TERMINATE. SYSTEM* 

not TERMINATE. SYSTEM. JOB. Yes> this is the OPPOSITE of what 
it used to be* 



4.7.1 DELETE. JOB. QUEUE 1 DELETE. JOB. QUEUES i DELJQ 



The purpose of this command is to delete all files from the 
job input subcatalog. the print subcatalog or both. This 
command is only allowed from jobs with operator and or system 

pr i vi I eges . 

delete. job. queue C queue. name = input* output • a I 13 

£status s <status varlable>3 

queue. name J gn* This parameter specifies from which 
subcatalogs files are to be deleted. Specifying 
INPUT will cause all files 'to be deleted from the 
job swap subcatalog and the job input subcatalog. 
Specifying OUTPUT will cause all files to be deleted 
from the job output subcatalog. Omission will cause 
all to be used. 

status J See ERROR HANDLING. 
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4.0 DUAL STATE DEAOSTART AND OPERATION 
4.7.2 REBUIID_INPUT_QUEUE \ REBIQ 

4.7.2 REBUItD.INPUT.QUEUE I RE6IQ 

The purpose of this command is to rebuild an entry in the 
Known Job List (KJL) from information in the System Label of 
the file representing the job being processed. This command 
is to be used during the process of recovering the input 
queues during recovery deads tart. 

rebui J d_i nput_gueue Cname*<neme>3 

C s t a t us « <s t a t u s v a r i ab I e> 3 

name * n? This parameter specifies the file name of the 
file representing the job. An attempt is made to 
process the specified file within the catalog where 
jot? input queues are known to reside. 

status! See ERROR HANDLING. 



4.7.3 REBf»ILD_t3UTPUT_QUEUE \ REBOQ 



The purpose of this command is to rebuild an entry in the 
Known Output List (KQL) from information retained in the 
System Label of the file representing the output being 
processed. This command is to be used during the process of 
recovering the output queues during a recovery deadstart. 

rebui 1 d.output. queue r,name»<name>3 

Cst a tus-<status variable>3 

name J This parameter specifies the file name of the file 
representing the output* An attempt is made to 
process the specified file Mi thin the catalog path 
of where job output queues are known to reside. 

status: See ERROR HANDLING. 



4.8 EtQUIE_A&_IliEUI-EILE-E&QM-£lZG-ia-afiQ 

Through the system console, enter? 

Type 

X.DIS. 
USER, A, 8. 
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'*»*»## .*»»*»» .*»«f:)W»»«(*»4M#W«»*»jlW. 



*#*»»# .** ***»*#*»*#,*#*» 



GET* f i I ename. 

where filename identifies the input file to be routed. 

ROUTE,* fi iename»DC=LP*FC=RH. 



4.9 CQIiEISUEAIIDii-!lA!iAfi£13£tJI 



In order to run NOS/VE in a dual state env i r onment* certain 
hardware configuration rules must be in effect. Ail storage 

devices and channels that NOS/VE Hill request must foe in a 
•down* state In the NOS EST. For ?*ore information on the NOS 
EST* see the NOS Version 1 Operator* s Guide* 60435600* Section 
4. Refer to the E display. 

To run $2 S/H 104 in the standard configuration* channels 2 
and 32 must foe downed as shown below. 

D0yM*CH2. 
D0WN*CH32. 



4.9.1 SYSTEM CORE COMMANDS 



Configuration Management (CM) system core 
the system mass storage device. The commands 
detail in the MOS/VE Installation Command 
Section 3. The CM system core commands de 
configuration of the .system device and 



commands define 

are descr i bed in 

Interface ERS* 

! i ne the hardware 

the control I er 



accessing the 
shown here. 



system device. An example for S2 S/N 104 is 



SET OCT $7155.1 

SETOD $885 11 40(8) 



4.9.2 J08 TEMPLATE COMMANDS 



During sn installation deadstart* the Physical 
Configuration Utility (PCU) and the Logical Configuration 
Utility CLCU) must foe run. The PCU is run to describe the 
physical configuration that NOS/VE may access. The LCD will 



logically install all or part of 
and allow NOS/VE to access the 

utilities are described in the 



the physical configuration 
equipment. Commands for both 
NOS/VE Installation Command 
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4.9.2 JOB TEMPLATE COMMANDS 



Interface ERS* Section 2* 

The system device Khich was defined by the system core 
commands must the defined via the PCU* using the same 
controller and channel number. Additional devices may be 
defined as long as the device is in a dovin state* and all 
channels defined are also down. An example Is listed here. 



EXECUT 
SET 

SET 
SET 

SET 



SET 



SET 



SET 



INS 
QUIT 



E.TASK $ 
.NAINFRA 
JDATA.CH 

.OATA.CH 
.CONTROL 
PRODUCT. 
SERIAL. N 
.CONTROL 
PRODUCT. 
SERIAL. N 
.STORAGE 
PRODUCT. 
UNIT.NUH 
.STORAGE 
PRODUCT. 
UNIT.NUH 
TALL. PHY 



P=MANA 
HE.DEF 
ANNEL. 
ANNEL. 
LER.DE 
IDENTI 
UMBER* 
LER.DE 
IDENTI 
UMBER* 
.DEVIC 
IDENTI 
8ER=40 
.DEVIC 
IDENTI 
BER»40 
SICAL. 



GE.P 

INIT 

DEFI 

DEFI 

FINI 

FICA 

2. CH 

FINI 

FICA 

3 CM 

E.DE 

FICA 

<8) 

E.OE 

FICA 

(8) 

CONF 



HYSIC 

iqh n 

NITIO 
NITIO 

TIQN 

TION* 

ANNEL 

TION 

TION« 

ANNEL 

FINIT 

TION« 

CONTR 

FINIT 

TIOH« 

CONTR 

IGURA 



At. 

AIN 
N C 

N C 
ELE 

$71 
.CO 
ELE 
$71 
-CO 
ION 
$88 
OLL 
ION 
$85 
OLL 
TIO 



CON 
FRA 
HAM 
HkH 
MEN 
55. 
NNE 
HEN 
55. 
NNE 

EL 
5.1 
ER. 

EL 
5.1 
ER. 
N 5 



IGURATION 
E = S2 

£L.NUH8ER*2 
EL.NUMBER=18 
*CT1 .. 

* * 
TI0N»CHANNEL2 
*CT2 .. 

• * 
TI0N*CHANNEL18 
HENT=FHB40.A .. 

SERIAL. NU«8ER»1234 .. 
QNNECTIQN=CT1 
MENT«FMD40.B •• 

SERIAL_NUHBER*3456 .. 
QNNECTIQN=CT2 
INFRAHE«S2 



EXECUTE.TASK S P« N ANA GE.L QGI C A L.CQNF IGURATION 
INS TALL.LOGICAL.CONF IGURATION INCLUDE* ALL 
QUIT 



4.9.3 MJLTIPLE VOLUME CONSIDERATIONS 



If a configuration is used defining multiple mass storage 
volumes* the execution of the PCU and LCU will only permit 
access to the system device. In order to bring additional 
volumes online* the LCU must be run again. The user may want 
to Initialize a fresh volume. To do this* use the LCU 
subcommand INITHV. To add a volume to the NOS/VE set* l»e* 
to allow NOS/VE use of the volume* use the LCU subcommand 
ADDHTS. An example is shown here. 

EXECUTE.TASK. TP=HANAGE.LOGICAL.CONFIGUATION 

INITIALIZE. HS.VOLUHE £LEMENT=FHD40_B RECORDED. VSN* f VSN002 « 

ADD. MEMBER. TO.SET HEM8ER.VSN* « VSN002 » 
QUIT 
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4.9,3 MULTIPLE VOLUME CONSIDERATIONS 



During a nonJnstal lat ion deadstart* an attempt will be made 

to bring all logically configured volumes online and 
reactivate them* This means the above sequence need only 
occur when a new volume is being brought online the first 
1 * m e • 

Reference has been made to the NOS/VE Installation Command 
Interface ERS* To get a copy of this document on S/N 101* 

enter $£S*HAD.lISTfctIH . 



*.10 i£_QIS.£LAX-A5£Il 



Support of 6-12 ASCII from the console (K display) causes 

the following changes* 

mmi isAHSiAiEH-ifl imui iemsuieh-iq 

/l 
11 n 

n # 

/4 $ 

/ 5 (reversed /) 

/6 ; 

11 ? 

IB i 

19 > 

10 _ (underscore) 



4.11 £GQ.AI4a-IiSfiI-Ifcl£Q&aAII0ti i 

Most of the steps listed here are used to gather l 

information for recovery problems* etc. If you do not wish to * 

do this* execute steps D and E only (EDO dump and NOS level 3 * 

deads tart). » 

A. Enter DR I at the HDD display. J 

8. Enter HP at the HDD display. \ 

C. If I0U.FS1 NOT * OR I0U.FS2 NOT = THEN do HOT enter ? 

DU at the HDD display ELSE do enter DU at the HDD \ 

display. \ 
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« Press deadstart button and perform EDO* 

1) Mount scratch tape (ring in) on a 9-track drive* 

2) Push D/S button. 

3 ) Select U (utilities) display. 

4) Select E (EDO) display. 

5) Set channel (S2-13). 

6) Set ECUU CS2*01uu> 

£ » equi pnient 

C = 1 for 67X drives* 2 for 66X drives 
uu * unit number of the tape drive to be used. 

7) Answer "dump number" with a CR. 

8) Answer "non zero inhibits rewind** with a CR* 

9) Answer ''channel control ware" with a CR. M££0i.£fll 
if this step is omitted* 0501 canot process the 

dump tape. 

E. Perform a level 3 NGS deadstart (See Section 4.13). 

F. If you are running on the S3* enter the following at the 
console: 



X.DIS. 

USER*IHT1,INT1X. 

GET»DMPDFS/UN=JLG. 

BEGIN*. PMPDFS. 



DROP. 



This is a procedure to dump several dayfiles associated 
with the NVExxxx job and are needed along with the EDO tape to 
adequately debug a NOS/VE hang. 

Some of the crashes that NOS/VE encounters will cause 
NOS/VE to terminate such that the operator will notice the 
K-display which requests that a K.*RUM. be entered. Before a 
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K.*RUN. is entered the EOD should be performed* J 

To create a fisting of the EDD tape* type SES* INT1.D5DI See * 
the procedure's HELP documentation for parameter * 
descriptions. » 

C170 DSOI information can be found in Chapter 10 of the NQS 

SYSTEH MAINTENANCE Manual. 

A170 DSDI info can be found in document ARH3060 — GID for 

A170 N0S/S2. 



4.12 HQSZiLE-IfiSaiBAIIDS 

o Bringing down dual state: 

K*NVE. 

K.TERMINATE.SYSTE* 
o If not a normal termination 

K»NVE. 

K.*RUN. 

K.*ENDLST. 

K.*ENDRUN. 

4.13 AlZfl-MflS-SUUIflaMH 

Before leaving the machine* it is necessary to bring NQS 

down. If NOS has crashed* a level 3 deadstart must be 

attempted even if the only reason is to bring NOS down. To do 
a 1 eve ! 3 deadstart : 

1) Push D/S button 

2) Select "0" displ ay 

3) Select *P W display 

4) Enter 1=3 

5) Enter (CR) 
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6) Enter date/time 

If a dump is desired but a crash has not occurred STEP* 

should always be entered before pushing the deadstart button* 

After the dump has been taken a level 3 deadstart should be 
performed* 

To bring NOS down* do the following! 

1) Enter? 

CHE 

The screen will display: 
CHECKPOINT SYSTEM* 
Enter: carriage return 

2) Hake sure no a?as$ storage device has a checkpoint 
r quested* To do this* enter: E*W» If the display shows 
there are no **C M s in the status field* then alt devices 
are checkpointed and you may continue* 

3) Enter: 

STEP. 

4) Push deadstart button* 
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5.1 S£IJl£_EaSflAI 



The general, format of the SETVE command is 

X.SETVE<PN*ffff ,UN=un>VSN*vsn»D«d>P»p#8«b.C*c*CH*ch) 

ffff is a string of no more than four characters. SETVE 
appends ffff to 'NVE 1 to construct the nane of a 
procedure file which* when invoked* will deadstart 
NDS/VE. The default is TST. 

on specifies the user number from which TPXXXK is 
attached. Un is the first catalog searched for 
other files used in deadstarting and terminating 
NQS/VE. The default is INT1. 

c specifies the deadstart command deck to fee used when 
deadstarting MOS/VE. The function served by the 
deadstart command deck is analogous to the function 
served by the CHROECK of NOS. Currently supported 
values for c and their respective uses are: 

1 Arden Hills S3 S/N 02 open shop/hands-on time 

3 Arden HI lis S3 S/N 02 closed shop 

6 Arden Hills 52 S/N 104 open shop/ hands-on time 

10 Sunnyvale SZ closed shop installation 

40 Sunnyvale S2 closed shop continuation 

The default is set in the file CM0S1. Currently 

the default is 6. Maiainal-.SssfiilY.iQa £=6 an £&£ 

kLtea iiiiis £2 aiii sle.&i£.fi*-£Q£-£lQ£Z¥£-2£i:i£a£Qi 

£ii£-.ka££*- 

b specifies an alternate catalog to be searched for 
the various files used in deadstarting and 
terminating MOS/VE. The default is INT1. 

d is used to indicate that the system core command 
processor should accept commands from the console* 
Specifying 0~T in the SETVE command allows the 
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operator to enter commands from the console after 
processing the deadstart command deck. If the 
operator wishes to initialize the system device 
and/or install a new version of NOS/VE* D-T must be 
specified. The default is set in the file CMDS1* 
Currently the default is D=F. 

P specifies the password for the catalog indicated by 

the un parameter* If this parameter Is omitted the 
password Hill be generated by appending an •X' to 
the UN parameter* 

ch specifies the octal channel to be used for NOS/VE 
disk I/O. The default is set In the file CMDS1* 
Currently the default is 2. 

vsn specifies the vsn of a deadstart tape. If this 

parameter is used then NOS/VE will be deadstarted 

from the tape specified. If it is omitted* then 

NOS/VE will be deadstarted from the permanent file 
TPXXXK. 



5.2 SEm.USAfifi 



Earlier versions of NOS/VE required that two SETVE commands 
be issued if the system was to be installed and subsequently 
recovered. The current system does not require this. The 
only reason for issuing two SETVE commands is to provide a 
deadstart procedure that does not require/permit operator 
inter vent i on • 

It should be noted that once the SETVE command has been 
issued* it need not be issued again unless... 

1) There is a need to change one or more of the parameters 
specified in SETVE* 

2) The command file* NVEffff* generated by the SETVE 
command Is purged from the system* 

Two examples of SETVE usage and subsequent NOS/VE deadstart 
are given below* The first example shows a "hands on" user 
working with recovery. The second illustrates these concepts 
for a typical NOS/VE closed shop. This writer hopes that the 
reader will find both examples useful and illuminating. 

I. A "hands on** user 
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The command file N VERSO is built and installed in NOS 

by typing 

X.SETVE<RSD,UN*RSD.V$N«TAPE-B*DEV1.C«6*D»T> 

Several of the choices of parameters are aorth 
not I ng* 

1) 8y specifying the VSH parameter the user has built 
a command file that * I I I deads tart the system 

directly from the tape produced by MVESYS* 

2) The user in this example has specified deadstart 
command deck 6 (C parameter) and has allowed the 
NOS/VE disk I/O channel (en parameter! to default 
to 2* One concludes that the user is running on 
the Arden Hilts S2. 

3) The user has specified D*T* This is important* 
The deadstart command «hich triggers installation 
of a recoverable system cannot be read from a 
deadstart coMand deck* It must fee entered from 
the console at deadstart time* Specifying D«T 
allows the operator to enter commands from the 
console* 

NOS/VE is deadstarted by typing 

NVERSD. 

at the console* 

The user brings up the K display by typing 

K.NVE* 



Presently* the deadstart command deck is displayed 
and the user is prompted for input* The deadstart 
command deck used in this example looks like thiss 



USECP 
USEIP 
SETDCT 

SETDD 



S2CFIG 

EHPTY 

$7155.1 

$865.12 32 



The user types 
K*INXTDD VSN001. 
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K # G » 

The system accepts the commands and installs and 
deadstarts NOS/VE. 

After the system comes down* via either controlled 
termination or "a crash* the system can be recovered (if 

necessary) and redeadst arted by typing 

NVERSD. 

Hhen the deadstart command deck is displayed* the 
user types 



This will cause NOS/VE to be deadstarted without 
initializing the system device. 

XI* A typical "closed shop"* 

Two command files* NVECLSH and NVEINST* are created 
by typing 

X.SETVE<CLSH*UN»CLSH>B»DEV1»C»40»CH*1) 
X.SETVE(INST*UN*CLSH*B«DEV1*C«10»CH«1»D*T) 

One notes that 

1) Closed shop is deadstarted from a TPXXXK file in 

the CLSH catalog. 

Z) Specifying D = T* for NVEINST* causes deadstart to 
pause for operator intervention. 

3) Using DC F deck 40 for continuation suppresses 
redundant (and possibly damaging) reexeeution of 
the configuration prolog. 

A normal deadstart is used when bringing up HOS/VE at 
the beginning of closed shop or following a system 
failure. The operator* in this example* types 

NVECLSH. 

NOS/VE will recover (if necessary) and deadstart. 
When recovery runs* the operator must respond to a 
request for input from the HANLC utility. See note 4 at 
the end of this section for more information. 



Cycle 7* July-August 1982 



NOS/VE Cycle 7 Helpful Hints 



5,0 RECOVERY OF NOS/VE PERMANENT FILES 
5.2 SETVE USAGE 

W«W*WWI«»NN4IW«WMI«W»WW«f*<*«««li«««MM««ttN«WMW*W.WH«IWMW»WMN 



5-5 



09/14/82 



n xt m m *§ m m m mm ************ 



If it is necessary to reinitialize the system device* 
or If the installation is upgrading to a new version of 
NOS/VE* the operator keys 

NVEINST. 

This causes deadstart to pause and wait for operator 
input when deadstart commands are being processed* 
There are two cases requiring discussion here. The 
first is the case of upgrading to a new and compatible 
version of NOS/VE • The second case is used only -when it 
is necessary to reinitialize the system device* 

The first case involves the installation of a new 
version of NOS/VE. In order to install a new version of 
the system* the old system must have been idled in an 
orderly way. A new system cannot be installed if* 
following a crash* the system being superceded was not 
recovered* Assuming everything in the old system is 
tidy* and the file systems are compatible* the operator 
keys 

K.USECP EMPTY, 

K.SE'TSA INSTALL_JOB_TEWPLATES 1. 

K.GCJ. 

when the system displays the deadstart command deck and 

prompts for input. The new system is installed* the 

file system is preserved* and deadstart proceeds. 

The second case amounts to an installation 
deadstart. This should be used only with full knowledge 
that any files which may have existed on mass storage 
prior to this deadstart* aiil.tU-fclASlfid into. fi&lilifiB 

An installation deadstart will he required if 

1) This is the initial installation of a recoverable 
version of NOS/VE. 

2) If the file systems of the system being installed 
and the system being superceded are not 
compatible* 

3 ) If the file system has been damaged beyond the 
possibility of recovery. 

An installation deadstart is effected by typing 
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K*XNXTDD VSN001. 
K • v» • 

when the deadstart command deck 
operator is prompted for input* 



is displayed and the 



NOTES? 



1. The CHDS1 file used to deadstart NOS/VE must have 



the DEBU62 flag set to TRUE* 



yhen 



iS/VE is 



deads tar ted* 
par ameter i s 
f o I I owed by 
parameter * 



the catalog 
first in the 
the catalog 



specified by the UN 

search order for CHDS1» 

specified by the B 



2* Sea Section 3*3 of the Integration Procedures 
Notebook for other information about the CMDS1 
f lie* 



3* If NOS/VE crashes and a dump 
context of our second example) 



is desired tin the 



1* Type du at the HDD console. The message 



"WRITING IMAGE 
imnied i at el y • The 
COMPLETE" should 

later* 



FILE** should appear 

message "IMAGE FILE 
appear a few moments 



4. 



ii. Push the deadstart button* 

ill* Take the EDO dump* 

iv* Do a level 3 NOS deadstart* 

Alternatively the operator can skip step i if 
she/he is sure to redeadstart NOS/VE after step 
iv* In this event the system will detect that the 
image file was never created* will create one* and 
Mill recover f roir? it* 

A recovery deadstart which Is under the control of 
a SETVE command in which D~T was specified will 
pause in the recovery system with the message 
"OPERATOR INTERVENTION BEFORE RECOVERY BEGINS*** 
The system is executing the logical configuration 
utility at this point* In order to exit this 
utility and allow recovery to proceed the operator 
types K. QUIT (no period)* For more details on the 
use of the LCU see Section 4*9 of this document 
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and the NOS/VE Installation 
ERS. 



Command Interface J 
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6.o sisi£fl-£afi£-Q£aufifi£a 



The System Core debugger provides a set of capabilities 
intended to assist in debugging the .operating system. 
Services provided h : ^ the debugger are task oriented? selection 
of the tasks to be debugged must be made via debugger 
subcommands. No tasks will be under control of the debugger 
unless they are selected. The selection capability allows any 
number of tasks to be debugged simultaneously,; from one task 
to all tasks in the system* Obviously a capability this 
powerful must be used with some care. The System Core 
debugger uses the debug hardware to provide these 
capabi 1 i t i es • 



6.1 SI3Q£MJ£ 



The purpose of this command is to initiate execution of the 

system core debugger. This command can be issued from the 
deadstart command file or as a command in any job. 

sysdebug 

This command has no parameters? all information the 
debugger requires is provided via subcommands. 

The system core debugger can also be invoked from the HDD 
console. The format of the command is? 



DO n. sysdebug 

where n is the job ordinal of the desired job. The debugger 
is brought up in the job monitor task of the job. All system 
core debugger subcommands are available* but must be prefixed 

by the HDD command DO. 

The system core debugger can also be brought up (from the 
HOD console) by specifying a global task id. The format of 
the command is? 

DO n.t debug gggggg 

The value of n is ignored* and the value gggggg specifies the 
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6*1 SYSDHBUG 

NQS/VE global task id C3 hex bytes) of the task to bring the 
debugger up in. If the task id is invalid* then the command 
Mill be ignored* 

6 . 2 SUatQmt!iJL.EA&AtiEI££-QEEIfclIIiati5 

<name> Ji= 1-8 character breakpoint name 

<condl tion> : s = READ J WRITE 5 RN I J BRANCH 5 CALL SOI VFIT URL OS J 

AROVFLJEXQVFLSEXUNFLSFPLOSSfPINDEFJINVBOP 
<base> s:= process virtual address 
<offset> 5!= integer 
<length> ss« integer 
<frame> :: = 1..100 
<count> s : ~ 1. .10000 
<regid> : := X\M? 
<regno> s:« . .15 JO. .OF { 16) 
<value> !?s integer 
<time> ::« l..(2**31)-l 
<vstrlng> ::= •charstring* 
<datatype> ?:* HEXUSCII USC 1 DEC 
<ehange_count> ::* 1..8 
<se lector > :s» FULL! AUTO 5SAVE 

6 . 3 miEW-COEE-flEfiUfifiEa-SUatQSfiAHQS 

Within the descriptions which follow* optional parameters 
are enclosed in brackets. Default values for optional 

parameters are also defined. 

6.3.1 SELECT 

The purpose- of this subcommand is to select the tasks in 
which the system core debugger is to be active. When the 
debugger is first called* it is not active in any task. To 
use the debugger therefore* it is necessary to select the 
tasks in which it is to beactive. 

select <selection option> t<r ing nun?ber> ! <active job list 
or d i na l>] 

se I ect i on.oot ion: This parameter specifies one of a 
series of selection options used to control the 
tasks in which the debugger will be active and some 

Cycle 7* July-August 1982 



OS/VE Cycle 7 Helpful Hints 



«IMWMWWM«rwMW«IWWWW««NWW»«r«NW«J»«WMN»«»«NI»*«*N«WM«l»««l««W»**»»« 



6-3 



09/14/82 

mm** -mm wnwwww 



6.0 SYSTtH CORE DEBUGGER 
6.3.1 SELECT 
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other debug options. The selections are remain in 
effect until they are explicitly changed with 
subsequent SELECT subcommands* Valid selection 
options ares 

<rlgbt*left> - This selects the screen for the debug 

display. The display stays active when the screen 
Is switched. 

< jobmoni tor Ino jobwoni tor> - This selects whether or 

net to debug job monitor tasks. 

<user % nouser> - This selects whether or not to debug 
user tasks <I.e. those that are not job 
moni tors ) • 

<nighring> - This specifies the highest ring in 

which debug traps Mill be recognized. Traps 

occurring in rings above this selection will be 
i gnor ed. 

<job'nojob> - This enables or disables debugging for 
the job at the specified active job list 
ordinal. The system job has an active job list 
ord ina I of zer c. 

<alijobs*nojobs> - This activates or deactivates 
debugging in all jobs* 

The initial selections are: RIGHT* NGSTEP* 

MOJOBMONITORf HOUSER, HIGHRING»3* NQJ08S. 



6.3.2 BREAKPOINT \ 8 



The purpose of this subcommand is to select a program 
Interrupt which is to take place upon occurrence of a 
specified condition within a specified virtual address range. 

breakpoint <name> <condition> C<base>l £<offset>3 f.<lengtb>] 

The <name> is any user supplied name for identifying the 
breakpoint* A maximum of thirty two breakpoints can be 
selected. When a trap occurs* the <name> of the breakpoint 
which caused the trap is displayed. 

The base parameter is required when specifying a new 
breakpoint name? offset and length specifications are optional 
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6.3.2 BREAKPOINT ? 8 

in this case. When adding a neM condition selection to an 

existing breakpoint* base* offset* and length parameters may 

not be specified. 

Base* offset* and length parameters define the desired 
virtual address ranges <base> + <offset> yields a 
first-byte-address; first-byte-address •*• <length> -1 yields a 
last byte address. 

Default parameter values? 

<offset>i 

<iength>: 1 



6.3.3 REMOVE. BREAKPOINT J «B 



The purpose of this subcommand is to deselect a 
selected program inte 



previously 



refi30ve_breakpo int <name> £<cond i tlon> J 

If only the name parameter Is specified* all conditions 
associated with the breakpoint ^re deselected and all evidence 
of the breakpoint is removed. If the condition parameter is 
specified* only that condition is deselected; however* if the 
specified condition is the only condition selected* ail 
evidence of the named breakpoint Is removed. 



6.3.4 LIST_3R£AKP0INT J IB 



The purpose of this subcommand is to provide a list of 
currently selected breakp and associated conditions. 

I i st.breakpoint C<name>3 

If the name parameter is specified* information is 
displayed for the named breakpoint only. If the name 
parameter is not specified* information is displayed for ail 
currently defined breakpoints. 
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6.3,5 CHANGE BREAKPOINT J CB 



The purpose of this subcommand is to change the virtual 

address range of a previ specified breakpoint. 

change.br eakpoint <name> <base> Koffset>3 C<length>3 

8ase# offset* and length parameters define the desired 

virtual address range: <base> + <offset> yields a 

first-byte-address? f I rst-byt e- ad dress + <length> -1 yields a 

last byte address. 

Default parameter values! 

<offset>: 
<length>* 1 



6.3.6 TRACE.BACK J T 



The purpose of this subcommand is to provide information 
relevant to stack frame associated with an interrupted 
procedure and its predecessor procedures. Validation of PVA's 

is now performed. 



Inf orai a ti on 
consists of: 



lisp I eyed 



for each selected stack frame 



- Stack frame number; 

- Current P-address of the associated procedure; 

- Virtual address of the start of the stack frame; 

- Virtual address of the stack frame save area. 

trace_back [<frame>3 [<count>3 t FULLS SHGRT3 

The frame parameter specifies the number of the first stack 
frame for which information is to be displayed. Stack frame 
number one is associated with the interrupted procedure* stack 
frame two is associated with the interrupted procedure's 
predecessor* etc. 

The module name provided on the traceback is usually 
correct but not guaranteed. 

The count parameter specifies the total number of stack 
frames for which information is to foe displayed. 
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Default parameter values: 

<frame>: 1 
<count>: 1 



6.3.7 DISPLAY.STACK.FRAME J DSF 



The purpose of this subcommand is to display selected 
Information from a specif i stack frame. 

displ ay_stack_fr ame C<fraaie>3 £<sel ector>3 

The frame parameter specifies the number of the stack frame 
for which information is to be displayed. (Stack frame number 
one Is associated with the interrupted procedure* stack frame 
t*o is associated with the interrupted procedure»s 

predecessor # etc.) 

The selector parameter identifies a region of the specified 

stack f raffles 

AUTOi Causes the automatic region of the stack frame to he 

displayed. 

SAVE? Causes the save area of the stack frame to be 
d i sp I ayed. 

FULL* Causes both the automatic and save areas of the stack 
frame to be displayed. 

Default parameter values? 

<frame>s 1 
<selector>: FULL 



6.3.8 DISPLAY.9EGISTER ? DR. 



The purpose of this subcommand is to display the contents 
of a specified registe interrupted procedure. 

dt spl ay.r egi ster <regid> C<regno>3 C<datatype>3 

Default parameter values! 

<regno>i o 
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<datatype>: HEX 

6.3.9 DISPLAY. MEMORY J 0.H 

The purpose of this subcommand is to display the contents 
of a specified area of virtual memory* Validation of PVA's is 
now performed. 

displ ay.meiaory <base> C<fength>l 

Default parameter values? 

<length>: 8 

6.3.10 CHANGE. HEHQRY I CM 

The purpose of this subcommand is to set a specified value 
Into a specified loca of virtual memory for a specified number 
of bytes. Validation of PVA's is now performed* 

change.memory <base> <va!ue> <change_count> 

Default parameter values: 

<change_coun t>s 1 

6.3.11 RUN 



The purpose of this subcommand is to invoke program 
execution after a selected p interrupt has occurred. 

run 



6.3*12 SUPER. CHANGE. MEMORY \ SCM 



The purpose of this subcommand is the same as the change 
memory subcommand* that is* to change the contents of virtual 
memory. It differs from change memory* however* in that it 
will change the attributes of the segment to allow memory to 
be written* and then change the attributes back to. their 
original values* 
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6.0 SYSTEM CORE DEBUGGER 

6.3.1.2 SUPER„.CHANGE_MEMORY J SCH 



The command format 
subcommand. 



is the sam? 



as the change men or 
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6.3.14 UMFORHAT I UNFMT 



The purpose of this subcommand is to leave the output mode 
established by the FORMAT command* Output will again foe sent 
to the operator console. At this point the permanent file 
will be flushed to mass storage. 

unf ormat 



3.15 0ISPLAY_M0NIT(1R_FAULT J DIS^F 



The purpose of this subcommand is to display any monitor 
faults present in this task. See the section titled 'NQS/VE 
Processing of Job Mode Software Errors' for more information. 



AH monitor fault buffers sre displayed in the hope they 



will show some task history. 

invalid the message "following 
displayed. 



If a given fault buffer is 
fault is not present" is 



di spl ay_mon i tor. fault 
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6,3.16 DI$PLAY_XC8 J DISXCB 



The purpose of this 'subcommand 
fields of. the current task's (i.e.* 
debugger) execution- control block. 



is to d ispl ay alt of the 
the task running the 



6.3.17 DISPLAY.TASK. ENVIRONMENT J DISTE 



The purpose of this subcommand is to display the 
tasks running within the current job (i - " L ~ ' 
task running the debugger). If the 
the debugger is in format mode* then 
otherwise just the task name* XCB 
are displayed. 



XCB of al I 

e.» the job «i th the 

command is entered uhile 

a full XC8 is displayed* 

address and global task id 
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Tasks running in job node will occasionally cause an error 
which is detected either fey the hardware or NOS/VE monitor* 
The action taken when an error like this occurs is controlled 
by various system attributes* The purpose of this section Is 
to discuss the types of errors and the effect a given system 
attribute Mill have upon the handling of the error* 



7.2 II££i_QE_£&Rfl&S 



1) BROKEN TASK: a broken task is a task in which the trap 
mechanism is not able to function correctly* NOS/VE 
monitor will attempt to repair the trap mechanism and ser>6 
a broken task fault to the task* The specific cases of a 
broken task are: 



system error 



job mode software has 
declared the task to be 
broken* (This is a special 
case of broken task.) 



monitor fault buffer full 



traps disabled 



job mode errors are 
occuring but are not being 
processed by job mode* 

a job mode error has 
occurred while traps were 
d i s'abl ed« 



invalid AO 

UCR/WCR traps disabled 



the task's AO register was 
invalid* 

UCR/MCR error occurred with 
traps disabled. 



2) MCR FAULT: This error signifies that job mode caused a 
hardware detected MCR fault* This may be caused by 
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7,0 HQS/VE PROCESSING OF JOB MODE SOFTWARE ERRORS 
7,2 TYPES OF ERRORS 

software or hardware detected uncorrectable error* 

3) UNKNOWN SYSTEM REQUEST? This error signifies that job mode 
issued a monitor request that is either invalid or cannot 

be issued from the ring it was issued from. 

4) SEGMENT ACCESS FAULTS: These errors signify that job mode 
encountered or caused one of the following errors! 

page fault for an s66ress greater than EOI on a 
read-only file (segment) 

- disk read error 



These errors either originate in NOS/VE monitor or cause 
the hardware to exchange to monitor* Depending on the values 
of certain system attributes* monitor will halt or reflect the 
error hack to job mode as a monitor default* 



It is at this point that the system core debugger can be 
activated. (See the definition of SYSTEW.DEBUG.RING in the 
next section*) 

Tne normal job made OS actions for these faults are: 

broken task ex i t 

NCR fault cause condition 

Invalid system request exit 

segment access cause condition 



7*3 SXSI£tt-AmiJ&LiIEi_£QB-E£fiQE_£&fl£ESSIfl£ 



The following system attributes can be set or displayed by 
the SETSA and OISSA commands* 



7,3.1 HALTRING 



If a broken task or HCP fault occurs at or below the value 
of HALTRING (P register ring number)* HQS/VE monitor will halt 
the system* Broken tasks occurring above HALTRING will cause 
a monitor fault to be sent back to job mode. 
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7.3.2 SYSTEM_ERRGR_HANG_COUNT 



This is the number of broken task errors allotted to occur 

in any given task before that tssk is considered a hung task. 



7.3.3 HALT.QN_HUNG.TASK 



tribute is true* then an occurence of a hung task 
NOS/VE monitor to halt the system* .If the 
false* the task will be sent a signal to •hang* 

to go into an infinite wait doing nothing. Jobs 

the status field on the 



If this a 
will cause 
attribute is 
itself* i.e. 

with hung tasks Mill have a 
operator CP display. 



*H in 



A hung task 
mode ring 1. 



ill also occur if any error happens in job 



7,3.4 SYSTEM_DEBUG_RING 



If an error {broken task* NCR fault* unknown system 
request* or segment access fault) occurs at or below the value 
of this attribute (P register ring number)* the system core 
debugger will be invoked within the task. At that point In 

time the task environment can be examined fey using system core 
debugger commands. 



If the 
will take 



RUN command is issued to the debugger* the system 
ts normal action for the specific fault. 



7,3.5 DUMP.WHEN.DESUG 



When the system core debugger is invoked by a fault at or 
below SYSTEM.OEBUG.RING and the DUMP_WHEN_DEBUG attribute is 
true* the debugger will automatically create a dump of the 
task (see system core debugger command FORMAT)* When the dump 
Is complete. normal fault action will take place. The 
following system core debugger commands are executed during an 
automatic dumps 



FORMAT automatic 

TB 1 XOOC 
OISMF 



dump data 
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7»0 NQS/VE PROCESSING Of JOB MODE SOFTWARE ERRORS 
7.3,5 DUMP_WHEN_DEBUG 

OISXCB 

Oli 0030000D000 10000(16) 
DM 00400000000 10000(16) 
DH 00500000000 10000(16) 
OH 00600000000 10000(16) 
OH OOPOOOCOCOO 10000(16) 
OH 01000000000 10000(16) 
DH 01100000000 10000(16) 
OISTE 
UN FORMAT 
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8.0 STAND ALONE DEADSTART 
8.0 SIABJ2.ALJ3fcl£-fiEAfiSIAai 



A standalone deadstart tape is a 9-track* unlabeled* I 

format* 1600 BPI density tape (produced by the NVESYS 

procedure). To deadstart In standalone mode* perform the 
following steps! 

1) Set the deadstart panel for stand&rti disk deads tart. 

2) Perform an alternate deadstart to the NVE deadstart tape 
using CTI, The CTI parameters on the , P I display should 
be set as follows 

L » 

C * <'C f parameter of the SETVE prccedure> 

- <*D* parameter of the SETVE procedure 

= Y when display is true 

D = N when no display> 
W14 - OCH 1 parameter of the SETVE procedure> 

31 The tape should love and eventually the message 
"PROCEED" will appear on the lower left on the console* 

4) Enter CP»tfx»BR*0QOOG00OOOQCGC0O (Editor's notes 16 
zeros! ) 

where Hx is HI for SI 
m for S2 
H3 for S3 

This clears the mawory bounds register which is set by th 
deadstart* 

5) Enter DR*P2 This displays the CPU registers* The SIT 
should be changing; If not* give up. 

6) At this point the systen core Is loaded and can be 
patched. The commands to display and change memory are 
documented in IPNOOC. 

7) To start the system enter SS The CPU registers should 
spin? if they ever stop the CPU has halted. 

8) Enter DO to display the system dayfile on the right 
screen . 
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9) Enter NVE deadstart commands **hen the system requests 
them. I'D » Y* must be specified on the f P f display for 
this to happen*) 

Note: Standalone deadstart is always a f quick f 
deadstart* so no recovery of permanent files is 
possible. •QU.ICKDS* mode is set internally and nte6 not 

be specified. 



10) Enter DJ to display the system job dayfile when the 
system requests it* The *0J f display is on the left 

screen. 



11) Now the system is operational and commands can be 

entered* 
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9.0 INTERACTIVE PROJECT DUMP ANALYSIS PROCEDURES 

9.0 I!4I£EACII^£-£&flil£CI-QU!!£-AliALISIS-£&QCEaUEES 



The following procedures were developed by the interactive 
project to assist them in interpreting dumps. They guarantee 
the procedures work if your user name is IFPj otherwise caveat 
emptor. For ?eore information about these procedures* contact 

Fred Sischke* 



The foil owing dump analysis procedures are available in the 

IFP catalog? 



9.1 



EDDSIM 

This is a CCL procedure which brings an EDD dump tape on a 
specified 

VSN into the simulator* The procedure can be accessed from 

the IFP 

cat a I og as f o H ows : 
get* eddsi jn/un* i f p 
begi n» » edds i m» vsn C vsn is the vsn of the EDD dump tape ) 



9.2 



IALEXC 



This is a Simulator INCLUDE file which does a preliminary 
analysis of 

the current simulator exchange package ( when the system 
crashes In task 
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9.0 INTERACTIVE PROJECT DUMP ANALYSIS PROCEDURES 

9.2 

services* this will normally be JP$ ). A qr exc s mon or qr 

exc-ma can be 

used to get into another exchange package before doing the 
include* 

The include file is ANALEXC/UN*IFP . It can be called froa? 
the simulator 

as foil ohs J 



•gat* anal exc/un- i fp • | include analexc 



(carriage return) a lone carriage return must be enterei 
after an IN.Cl.U0E 

in order to start it up 



9.3 



SEGDUMP 



This is a CCL procedure which calls DSDIV to dump a 
specified segment to 
a list file which can then be examined with an editor or 
printed. 

The procedure can be accessed from within the Simulator as 
fol lows: 



•gett segdump/un- i f p* ? * beg i n*# segdump#seg> I en» f i I e* exc> cpf » <* 

The segdump parameters are* 
seg - segment number in hex ( default Is 1 ) 
length - number of bytes to dump in hex ( default is 10000 ) 
list - name of the list file ( default is LIST ) 
exe - reference exchange package ( default is 4 PS 3 
cpf - name of checkpoint file (default Is CPF ) 

Cycle 7* July-August 1982 



' 9-3 

NOS/VE Cycle 7 Helpful Hints 

09/14/82 
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9.3 
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In ?POst cases of task services 
parameter is 



©bugging* only the sag 



needed* 



9.4 



MALJQB 



This is a CCL procedure which uses DSDIV* XEDIT and the 
Si aiul at or to 

perform an analysis of all tasks In a specified job. The 
procedure can 

be accessed from within the simulator as follows* 



* get* anal job/un-1 f p» ? ' begi n** ana I job* seg* cpf * 



The anal job parameters are: 

seg - the monitor segment which contains the exchange 
packages of the job ( 14 is the system job* 15 is job 1 etc. 
) ( default is 14 ) 

cpf - the name of the simulator file ( default is CPF ) 



After the procedure has completed* a list of the RHA's of 
the 

job's exchange packages can be obtained by doing the 
fo I lowing: 



include tp list 



(car r i age return) 



A traceback of all tasks in the job can be obtained by 
doing the 
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9.0 INTERACTIVE PROJECT DIW ANALYSIS PROCEDURES 
9.4 

f o I low* ngs 



include tb list 



(carr i age return) 



include tbrui 



(carriage return) 
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1*1 An introduction to CYBER 180 

1.2 C180 Instant 

1*3 Model Independent General Design Specification - 
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2*0 NOS Reference Manuals 

2.1 XEDIT V3.0 - 60455730 

2.2 IAF VI. User's Guide - 60455260 



2.3 NOS Version 2 Reference Set - Vol 3. 60459680 

4* 60459690 



Vol 



2.4 NOS Systems Programmers Instant - 60459370 

2.5 NOS Version 2 Operator/Analyst Handbook - 60459310 

2.6 NOS Version 2 Diagnostic Index - 60459390 

2.7 NOS A170 ERS 

2.8 HQS A170 GID - ARH3060 
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3.2 Command Interface ERS - ARH36G9 - obtained from 
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3.3 NOS/VE Procedures and Conventions 
obtained by SES.T00LD0C 



sesDoio 



3.4 listing of all NOS/VE Hodules - obtained by 
SES*DEV1.LISTNVE. See Integration Procedures 
Notebook for details. 

3.5 NOS/VE Internal Interface Maintenance Procedures 

Hemo available from S.C* Wood* 



3.6 Integration Procedures Notebook Obtained 
Acquire* rPNDOC/UN^DEVl. SES. PRINT* IPNDOC . 
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